Aller au contenu principal

ADR 0000 — Titre court de la décision, en une phrase

Comment utiliser ce gabarit

Copie ce fichier sous le prochain numéro libre (NNNN-titre-en-kebab.mdx), remplace les portions entre back-ticks, mets à jour le frontmatter, puis supprime cette note. Les sections Contexte, Options et Décision sont obligatoires ; les autres sont facultatives — retire ce qui ne s'applique pas.

  • Statut : proposed | accepted | rejected | deprecated | superseded par ADR-NNNN
  • Date : AAAA-MM-JJ (dernière mise à jour)
  • Décideurs : liste des personnes ayant tranché

Contexte et problème​

Décris le contexte et le problème d'architecture en deux ou trois phrases. On peut le formuler comme une question : « Comment faire X compte tenu de Y ? »

Facteurs de décision​

  • Facteur 1, p. ex. une contrainte, une exigence non fonctionnelle
  • Facteur 2, p. ex. une force en présence, une préoccupation
  • …

Options envisagées​

  • Option 1 — titre
  • Option 2 — titre
  • Option 3 — titre

Décision​

Option retenue : « Option 1 », parce que justification — le ou les facteurs décisifs qui font pencher la balance.

Conséquences​

  • Positives — p. ex. amélioration d'une qualité, débloque tel scénario.
  • Négatives — p. ex. dette introduite, contrainte nouvelle, coût.

Confirmation​

Comment vérifiera-t-on que la décision est bien appliquée ? p. ex. revue de code, test d'architecture, contrôle en CI.

Détail des options (facultatif)​

Option 1 — titre​

Description, exemple, avantages et inconvénients détaillés.

  • Bon, parce que argument.
  • Mauvais, parce que argument.

Option 2 — titre​

  • Bon, parce que argument.
  • Mauvais, parce que argument.

Informations complémentaires (facultatif)​

Preuves, liens vers d'autres ADR, notes de mise en œuvre, date de réexamen.