Qu'est-ce que Architecture Decision Record (ADR) ?
Un ADR rend une décision lisible pour les futurs collègues. Il consigne généralement le contexte (quelles forces étaient en jeu), la décision, les alternatives envisagées et les conséquences (les compromis avec lesquels on doit désormais vivre). Les ADR sont versionnés aux côtés du code et sont remplacés plutôt qu'édités — l'historique du raisonnement a autant de valeur que la réponse actuelle.
Également appelé : adr.
Termes associés
- Dérive d'architecture — L'écart qui se creuse entre l'architecture documentée et le système qui tourne réellement en production.
- Documentation vivante — Une documentation générée ou validée à partir du système en fonctionnement, afin qu'elle reste exacte à mesure que le système évolue.