Glossaire · Développement
ADR
Aussi appelé : Architecture Decision Record · Registre des décisions d'architecture
Définition
Un ADR (Architecture Decision Record) est un court document qui consigne une décision technique importante : le contexte, les options envisagées, le choix retenu et ses conséquences. Rangés dans le dépôt de code à côté du code lui-même, les ADR forment le journal de bord des choix d'architecture d'un projet. Le format, popularisé par Michael Nygard en 2011, tient en une page et se lit en quelques minutes.
Dans la pratique
Les ADR évitent qu'une équipe rediscute six mois plus tard une décision déjà tranchée, ou qu'un nouvel arrivant défasse un choix dont il ignore la raison. Ils sont aussi précieux pour les assistants de code IA, qui y trouvent le « pourquoi » des conventions du projet. Un tech lead ou un architecte qui en rédige naturellement est un bon signe de maturité.
Termes liés
Définition rédigée par L'équipe Top Profil. Glossaire mis à jour le . Tous les termes du glossaire.