La nouvelle fonctionnalité est prête, tout le monde est ravi. Les utilisateurices vont-ils savoir s’en servir ? Si vous pensez que le changelog et la PHPDoc suffisent, je voudrais vous demander : pourquoi priver vos utilisateurices des meilleures parties de votre logiciel ? Je vous propose de définir la qualité minimale attendue pour une documentation et d’examiner l’effort à fournir pour l’atteindre. Nous parlerons des process de documentation et de comment on fait pour documenter avec les moyens et les compétences disponibles.

Comments

Comments are closed.

lnc at 12:04 on 19 May 2018

Merci beaucoup pour cette conf ! Notre métier n'est pas fait que de code, j'apprécie qu'on parle aussi de tout ce qui gravitent autour du cœur de notre métier.

Plein de pistes à suivre et de ressources à consulter, merci :)

Conférence rondement menée avec l'humour que l'on connaît de mère Thérèse :D

Très intéressant, et ne se limitant pas qu'à la pure documentation technique, mais plutôt à l'écosystème gravitant autour de la documentation de code/applications.

Pleins de nouvelles ressources à explorer, merci pour les tuyaux !