L'objectif est de partager sur la manière dont vous gérez votre documentation (guide de référence, developper guide, installation guide, etc...) ?
On peut citer un certain nombre d'outils pour créer des documents comme
- traitement de texte (openoffice/word)
- wiki
- docbook
- xdoc
Lesquels utilisez-vous et dans quel cadre ?
Chacun de ses outils ont leurs avantages/inconvénients :
- Export dans différents formats (pdf,html,...)
- Facilité d'utilisation
- Format non libre de l'écriture de la documentation (xml)
- Gestion de profiles de génération
Quels sont pour vous les critères importants pour sélectionner un de ses outils ?
Enfin, votre outil de documentation s'intègre t-il dans votre outil de build ?
- avec maven ? si oui, quel plugin ?
- avec ant ?
Partager