Q: Elles sont dans quel format, tes docs, pour le moment ? On a un peu le même problème dans ma boite. A l'origine, il n'y avait pas vraiment de format standard pour les docs et les specifications (il n'y avait que quelques développeurs répartis dans 3 bureaux donc ça allait encore). Puis les applications ont grossi et le fonctionnel s'est largement enrichi. Il a vraiment fallu commencer à documenter tout ce qu'on faisait. Les gens ont commencé à faire de la doc en .doc (beurk). Le .doc ça prend beaucoup de place pour pas grand chose et en plus on ne sait jamais qui a la dernière version du fichier. Bref c'est devenu l'horreur.
On a commencé à explorer d'autres pistes. Fervant defenseur des formats ouverts, j'ai d'abord pensé à docbook. Sauf que j'ai eu bien du mal à trouver un éditeur un peu avancé qui évite de se taper du xml à la main. Il existe des outils pour OOo (templates + xslt) pour faire du docbook mais le logiciel n'étant pas vraiment conçu pour ça, il est facile de mettre son fichier en vrac. Et puis le XML brut pour le suivi des modification ce n'est pas top.
Dernièrement on mis en place un wiki et ça change la vie. C'est super simple à installer et à utiliser, on peut facilement suivre les modifications, corriger les erreurs, mettre des liens entre des sujets connexes et surtout faire des recherche dans toute la base de connaissance. C'est vraiment du bonheur. On est en train de tout basculer progressivement sur le wiki. Je ne sais pas trop quels sont tes pré requis pour ton système de gestion de documentation mais pour le moi le wiki c'est tout bon. Au fait, on utilise MediaWiki (le même système que sur Wikipedia).
# Deux trois trucs à voir
Posté par Croconux . En réponse au journal Gestion de documentation. Évalué à 4.
On a commencé à explorer d'autres pistes. Fervant defenseur des formats ouverts, j'ai d'abord pensé à docbook. Sauf que j'ai eu bien du mal à trouver un éditeur un peu avancé qui évite de se taper du xml à la main. Il existe des outils pour OOo (templates + xslt) pour faire du docbook mais le logiciel n'étant pas vraiment conçu pour ça, il est facile de mettre son fichier en vrac. Et puis le XML brut pour le suivi des modification ce n'est pas top.
Dernièrement on mis en place un wiki et ça change la vie. C'est super simple à installer et à utiliser, on peut facilement suivre les modifications, corriger les erreurs, mettre des liens entre des sujets connexes et surtout faire des recherche dans toute la base de connaissance. C'est vraiment du bonheur. On est en train de tout basculer progressivement sur le wiki. Je ne sais pas trop quels sont tes pré requis pour ton système de gestion de documentation mais pour le moi le wiki c'est tout bon. Au fait, on utilise MediaWiki (le même système que sur Wikipedia).