Architecture Decision Record

Active theme: Light

← documents

Comment commencer à utiliser les ADR

Pour commencer à utiliser les ADR, discutez avec vos coéquipiers des domaines suivants.

Identification des décisions :

  • Quel est le degré d’urgence et d’importance de l’AD ?

  • Doit-elle être prise maintenant, ou peut-elle attendre d’en savoir davantage ?

  • L’expérience personnelle et collective, ainsi que les méthodes et pratiques de conception reconnues, peuvent aider à identifier les décisions.

  • Idéalement, tenez une liste de décisions à prendre qui complète la liste des tâches du produit.

Prise de décision :

  • Il existe de nombreuses techniques de prise de décision, tant générales que propres à l’architecture logicielle, par exemple la cartographie de dialogue.

  • La prise de décision en groupe est un sujet de recherche actif.

Mise en œuvre et application des décisions :

  • Les AD sont utilisées dans la conception logicielle ; elles doivent donc être communiquées aux parties prenantes du système qui le financent, le développent et l’exploitent, et être acceptées par elles.

  • Les styles de codage architecturalement explicites et les revues de code centrées sur les préoccupations et décisions d’architecture sont deux pratiques connexes.

  • Les AD doivent aussi être (ré)examinées lors de la modernisation d’un système logiciel au fil de son évolution.

Partage des décisions (facultatif) :

  • De nombreuses AD se répètent d’un projet à l’autre.

  • Par conséquent, l’expérience acquise avec des décisions passées, bonnes comme mauvaises, peut constituer un atout précieux et réutilisable lorsqu’on applique une stratégie explicite de gestion des connaissances.

Documentation des décisions :

  • De nombreux modèles et outils existent pour consigner les décisions.

  • Voir les communautés agiles, par exemple les ADR de M. Nygard.

  • Voir les processus traditionnels d’ingénierie logicielle et de conception d’architecture, par exemple les mises en page de tableaux suggérées par IBM UMF et par Tyree et Akerman de CapitalOne.

Pour en savoir plus :