Agile Documentation: More Dialogue, Less Writing
Pourquoi documenter en Agile ?
Les exigences agiles et la documentation agile partagent un concept fondamental commun : Parler plus, écrire moins. L'objectif des User Stories est simplement de consigner suffisamment d'informations pour initier ultérieurement des conversations sur une fonctionnalité souhaitée. La documentation agile devrait poursuivre un objectif similaire : Créer juste assez de documentation pour qu'elle reste utile plutôt que superflue.
Les documents n'ont de sens que s'ils sont lus
Lorsque tu réfléchis à la documentation nécessaire pour un projet, commence par identifier quels documents ont été régulièrement utilisés ou jamais consultés dans ce projet ou dans des projets précédents. Encourage les discussions qui émergent lorsque l'équipe échange sur les différentes possibilités de documentation. Ces discussions révèlent souvent des documents qui, par le passé, n'ont pas été utilisés pour leur objectif initial ou n'ont pas été utilisés du tout.
Tous les documents régulièrement utilisés devraient continuer à l'être. Ceux qui n'ont pas été utilisés ne devraient probablement plus l'être (sauf s'ils sont exigés par des lois ou d'autres réglementations). Pour tout ce qui se situe entre les deux, l'équipe devrait voter ou trouver une autre façon d'arriver à une décision oui/non.
Mais ne t'arrête pas là. Pour chaque document qui continue d'être utilisé, l'équipe devrait réfléchir s'il n'existe pas une alternative qui permet de parler plus et d'écrire moins.
Exemple de documentation inutile
Par exemple, une équipe avec laquelle j'ai travaillé devait rédiger un « Database Impact Report » pour chaque modification effectuée. Mais la plupart des modifications n'avaient aucun impact sur la base de données, si bien que les 20 questions du rapport de cinq pages recevaient presque toutes la réponse « aucun impact ».
Ce document a été remplacé par une question supplémentaire sur la checklist de déploiement : « Les modifications de la base de données ont-elles été prises en compte ? »
Conclusion
Les équipes agiles ne sont pas fondamentalement opposées à la documentation. Elles cherchent cependant des moyens de passer des documents aux discussions. Une possibilité est de chercher des alternatives pour au moins certains des documents existants.
Et cela t'aidera à réussir avec l'Agile.
Tu veux mieux comprendre l'Agile et apprendre comment aider au mieux ton équipe ? Participe dès maintenant à une formation Scrum Master et deviens Scrum Master certifié en trois jours avec Agile Academy.
Cet article provient de Mike Cohn et a été traduit par nos soins.
