bah, on crie qu'il n'y a pas de documentation sans préciser à qui doit s'adresser ladite documentation... pour documenter l'API (à l'intention des développeurs), effectivement il vaut mieux que la documentation soit faite en même temps que le code (perldoc, javadoc, rdoc, et plus largement doxygen, noweb, etc.) dire donc que ça ne répond pas au besoin, je ne suis pas d'accord car il n'est dit nulle part que ce n'est pas le besoin :p
pour documenter le design général et l'architecture, je pense que les bases peuvent se faire à travers un wiki à condition de prendre le temps de le faire (mettre les idées au clair) avant de commencer a coder...
pour la documentation utilisateur, tout dépend du niveau de documentation voulu... pour un manuel rapide, ça peut être mis en place aussi par un wiki et être nourri par les développeurs et les testeurs... les manuels détaillés et les tutoriels sont par contre un boulot de rédaction à part entière pour lequel hélas peu de développeurs sont rompus
"It is seldom that liberty of any kind is lost all at once." ― David Hume
[^] # Re: Doxygen pour documenter le code
Posté par Gil Cot ✔ (site web personnel, Mastodon) . En réponse à la dépêche Calenco : une solution pour la documentation des projets libres ?. Évalué à 3.
pour documenter le design général et l'architecture, je pense que les bases peuvent se faire à travers un wiki à condition de prendre le temps de le faire (mettre les idées au clair) avant de commencer a coder...
pour la documentation utilisateur, tout dépend du niveau de documentation voulu... pour un manuel rapide, ça peut être mis en place aussi par un wiki et être nourri par les développeurs et les testeurs... les manuels détaillés et les tutoriels sont par contre un boulot de rédaction à part entière pour lequel hélas peu de développeurs sont rompus
"It is seldom that liberty of any kind is lost all at once." ― David Hume