AFUP Day 2019
[:fr]La parole est aux speakers : Sarah Haïm-Lubczanski (AFUP Day 2019 Rennes)[:]
[:fr]Jusqu’à l’AFUP Day 2019 Rennes, retrouvez nos interviews de speakers pour mieux comprendre leur parcours et le sujet qu’ils ou elles aborderont lors de leur conférence !
La conférence
No Doc, No Feature v2La nouvelle fonctionnalité est prête, toute l'entreprise se réjouit. Les utilisateur·ices vont-ils savoir s’en servir ? Si vous pensez que le changelog et la PHPDoc suffisent, je voudrais vous demander : pourquoi priver vos utilisateur·ices des meilleures parties de votre logiciel ? Je vous propose de définir la qualité minimale attendue pour une documentation aujourd'hui, 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 au sein de l'équipe. |
La Fabrique 17/05/2019 11:15-11:55 |
Cela sera ta deuxième conférence sur le sujet de la documentation à un événement AFUP. La documentation peut parfois être vue comme rebutante à écrire : comment motiver l’équipe à la rédiger ?
La documentation est vue comme rebutante à écrire par les développeur·euse·s car cela demande un vrai travail de formulation et de concrétisation de concepts abstraits et d’idées pour les partager. Ces idées peuvent être claires dans votre tête et il faut alors les transcrire. En fait, la documentation requiert des compétences de communication.
Lors de ma précédente conférence sur la documentation durant le PHP Tour 2018 à Montpellier, j’insistais sur le fait que les développeur·euse·s apprécient une documentation de qualité, et pourtant ne sont pas toujours prêt·e·s à investir du temps dans la production d’une documentation qui valorisera leur travail.