Zend FR
Consultez la FAQ sur le ZF avant de poster une question
Vous n'êtes pas identifié.
#1 23-06-2008 11:41:46
- julz
- Membre
- Date d'inscription: 19-07-2007
- Messages: 33
[résolu] Génération documentation comme Zend
Bonjour,
Savez-vous comment est géré la page du manuel sur le site du framework ?
> rubriques 1 > ruriques 1.1
> gestion des pages précédentes, suivantes
> liste des exemples
Ca m'étonnerait qu'ils génèrent toutes les pages html à chaque mise à jour, donc est ce une "moulinette" interne ou existe t'il un projet pour cela.
J'ai bien regardé phpdocumentor, mais ca m'a pas l'air de coller...
Merci bien, ça m'interesse bien pour gérer les docs utilisateur, simple et pratique
Dernière modification par julz (23-06-2008 14:32:01)
Hors ligne
#2 23-06-2008 12:28:25
- lethak
- Membre
- Lieu: France
- Date d'inscription: 05-04-2008
- Messages: 168
Re: [résolu] Génération documentation comme Zend
ça dépend... il y a la phpdoc, mais je pense que ce que tu évoque c'est bien le manuel rédigé a la main avec exemples, explications, etc.
Aucune moulinette ne peut rédiger une explication de fonctionnement 
Dernière modification par lethak (23-06-2008 12:28:57)
IT Dev @Twitter
Hors ligne
#3 23-06-2008 12:50:51
- julz
- Membre
- Date d'inscription: 19-07-2007
- Messages: 33
Re: [résolu] Génération documentation comme Zend
oui c'est bien la documentation explicative qui m'interesse..
Si je comprends bien, et en regardant le trunk avec la documentation, chaque module a sa propre feuille xml .
ils génèrent donc la doc (comme on peut le faire nous même) et la mettent à jour lors releases.
Hmm, c'est sûr c'est plus simple à gérer mais bon, dans mon cas, les rédacteurs de la documentation sont pas des développeurs donc c'est pas l'idéal
Si quelqu'un a un projet typiquement pour faire cela, je suis preneur, sinon je vais continuer mon application pour faire ça
merci pour la réponse
Hors ligne
#4 23-06-2008 13:19:39
- philippe
- Administrateur
- Lieu: Grenoble
- Date d'inscription: 01-03-2007
- Messages: 1624
Re: [résolu] Génération documentation comme Zend
Bonjour,
Regarde du coté des CMS (content management system) : dupral, joomla,...
A+, Philippe
twitter : @plv ; kitpages.fr : Création de sites internet à Grenoble et Paris
Hors ligne
#5 23-06-2008 13:37:50
- whitespirit
- Membre
- Date d'inscription: 25-01-2008
- Messages: 393
Re: [résolu] Génération documentation comme Zend
Sur le site officiel de ZF, dans la section concernant la documentation (là ou on passe 99% de notre temps sur le site) il y'a dans le coin haut-droit un onglet "behind the site". Il t'explique quelles technologies ils utilisent pour leur documentation....
...We also use Confluence and JIRA for the community wiki...
Peut-être que tu trouveras ton bonheur là dedans ?
Hors ligne
#6 23-06-2008 13:52:05
- Julien
- Membre
- Date d'inscription: 16-03-2007
- Messages: 501
Re: [résolu] Génération documentation comme Zend
JIRA sont des outils de déploiements applicatifs payants, et pas donnés.
Une documentation pour un End-User ca s'écrit à la main, et en général, ce ne sont pas les développeurs qui l'écrivent.
L'API de ZF est générée avec PHPDocumentor, et la doc est écrite en XML (DocBookXML) et compilée vers du HTM ensuite. Plus d'info ici : http://framework.zend.com/wiki/display/ … structions
Co-auteur de Zend Framework, bien développer en PHP
Hors ligne
#7 23-06-2008 14:31:09
- julz
- Membre
- Date d'inscription: 19-07-2007
- Messages: 33
Re: [résolu] Génération documentation comme Zend
oui, c'est bien ça, c'est fait à la main, comme moi je fais avec cgwin
Je vais continuer mon module d'aide pour utilisateur lambda (non développeur).
En gros c'est une arborescence avec articles associés à chaque rubrique..
Je me posais juste la question d'un outil similaire dédié à la doc étant donné que je retrouvais ce style de doc régulièrement.. c'est bête de recréer un truc déjà existant
Merci de vos contributions
Dernière modification par julz (23-06-2008 14:31:24)
Hors ligne
Développement par Kitpages