Consigner contexte, options et conséquences dans un Architecture Decision Record concis et utile au quotidien.
À qui cela s’adresse-t-il ? Équipes d’architecture et de développement qui souhaitent comprendre de façon permanente les raisons des décisions techniques.
Cas d’usage et contexte
Un Architectural Decision Record, ou ADR en abrégé, enregistre une décision pertinente et sa justification. Plus tard, ce n’est souvent pas la technique choisie qui est floue, mais pourquoi les alternatives ont été rejetées et quelles conditions s’appliquaient à l’époque.
Un ADR doit rester suffisamment compact pour être réellement lu. Il complète les aperçus d’architecture et les spécifications liantes, mais ne les remplace pas. Les entrées sur les décisions ayant des effets à plus long terme, telles que la responsabilité des données, les modèles d’intégration ou les services de plateforme centrale, sont particulièrement utiles.
La démarche en détail
- Formulez la question de décision. Décrivez le contexte, les objectifs et les contraintes de manière à ce que les futurs membres de l’équipe puissent comprendre.
- Comparez les options sérieusement envisagées. Notez les avantages, inconvénients et incertitudes ouvertes en fonction des critères pertinents.
- Documentez la décision, le statut et les conséquences. Ajoutez un lien vers une nouvelle entrée en cas de changement ultérieur au lieu de remplacer l’ancienne justification d’une manière méconnaissable.
Les résultats attendus
- Question de décision compréhensible
- Alternatives documentées et compromis
- Conséquences reconnaissables pour la mise en œuvre et le fonctionnement
- Historique lié des décisions modifiées
Préparer une décision éclairée
Un court modèle inclut le titre, le statut, le contexte, les options, la décision, les conséquences et les références. Nommer les parties prenantes et la date de la décision si cette information est effectivement connue.
Évitez la publicité pure produit et les affirmations générales telles que « à l’épreuve de l’avenir ». Décrivez plutôt quelle exigence est remplie et quel désavantage l’équipe accepte consciemment.
Questions et réponses
Est-ce que chaque petit changement nécessite un ADR ?
Non. L’effort doit correspondre à la portée de l’entreprise. Les décisions locales récurrentes peuvent souvent être couvertes par les normes existantes.
Que se passe-t-il avec un ADR remanié ?
Elle est préservée comme l’histoire et fait référence à la décision de remplacement. Ainsi, les conditions préalables de cette époque ne sont pas perdues.