Qu’est-ce qu’un enregistrement de décision d’architecture (ADR) ?
Un enregistrement de décision d’architecture (ADR) est un court document qui consigne une décision technique importante : son contexte, le choix fait et ses conséquences.
Comment ça marche
Michael Nygard a proposé le format en 2011 : un titre, un statut, le contexte, la décision et ses conséquences, numérotés dans l’ordre. Un ADR n’est pas réécrit quand on change d’avis : un nouveau le remplace.
L’ensemble devient la mémoire du projet. Un nouvel ingénieur lit pourquoi le système est ainsi, et personne ne rouvre une question tranchée sans avoir les raisons sous les yeux.
Un exemple
L’ADR 14 consigne le choix de PostgreSQL plutôt qu’une base orientée documents : les données sont relationnelles, l’équipe connaît SQL et les rapports ont besoin de jointures. Deux ans plus tard, l’ADR 31 en remplace une partie pour la recherche, et y renvoie.
Erreurs courantes
- Consigner les décisions longtemps après, sans le contexte qui était sur la table.
- Réécrire un ancien ADR au lieu de le remplacer.
- Ranger les ADR là où ceux qui en ont besoin ne regardent jamais.
Dans Nodary
Nodary propose un modèle d’ADR intégré. Une décision peut être marquée remplacée par l’enregistrement qui la suit, des liens disent de quoi elle dépend, et l’historique du document garde ses versions récentes à comparer et à restaurer.
Ce que Nodary ne fait pas : il ne garde pas les ADR dans votre dépôt de code : exportez-les en Markdown s’ils doivent vivre à côté du code.
Exporter depuis Nodary · Modèle de journal des décisions avec ADR
Essayez sur vos propres documents. L’offre Free ne demande pas de carte.
Créer un espace gratuit