documentation

Architecture Decision Record

Ne cherchez pas de contrepetterie dans ce titre. En disant cela, vous êtes tenté bien sûr d’en trouver une. Curieusement l’attirance pour l’interdit fonctionne souvent mieux que l’obligation. Tout le monde se rappelle que dans le manifeste agile il est écrit “un logiciel qui fonctionne plutôt qu’une documentation exhaustive”. Cette phrase a autorisé à braver le caractère obligatoire et exhaustif de la documentation. Il revient assez souvent que l’on me dise que dans les projets agiles, la documentation est trop incomplète voire absente.