Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

FAQ

Quels sont les avantages liés à la création d'un processus d'ADR ?

L'équipe du projet doit créer un processus d'ADR pour rationaliser la prise de décision architecturale, éviter les discussions répétées sur les mêmes sujets architecturaux et communiquer efficacement les décisions architecturales.

Quand l'équipe de projet doit-elle créer un ADR ?

L'équipe du projet doit créer un ADR pour chaque aspect du logiciel qui affecte la structure (modèles tels que les microservices), les exigences non fonctionnelles (sécurité, haute disponibilité et tolérance aux pannes), les dépendances (couplage de composants), les interfaces (APIset contrats publiés) et les techniques de construction (bibliothèques, cadres, outils et processus).

À quelle fréquence l'équipe de projet doit-elle revoir un ADR ?

L'équipe du projet doit revoir l'ADR au moins une fois avant de l'accepter.

Qui doit créer un ADR ?

Chaque membre de l'équipe peut créer un ADR. Nous vous recommandons de promouvoir une notion de propriété pour ADRs. Un auteur propriétaire de l'ADR doit activement maintenir et communiquer le contenu de l'ADR. Les autres membres de l'équipe peuvent toujours contribuer à un ADR. Le propriétaire de l'ADR doit approuver les modifications apportées à un ADR.

Quelles informations doit contenir un ADR ?

Chaque ADR doit au minimum définir le contexte de la décision, la décision elle-même et les conséquences de la décision pour le projet et ses livrables. Le contexte doit mentionner les solutions possibles envisagées par l'équipe. Il doit également contenir toutes les informations pertinentes relatives au projet, au client ou à la pile technologique. La décision doit clairement indiquer, dans un langage impératif, la solution que l'équipe a décidé d'adopter. Évitez d'utiliser des mots tels que « devrait » et formulez chaque décision comme « Nous utilisons… » ou « L'équipe doit utiliser… ». La section sur les conséquences doit mentionner tous les compromis connus liés à la prise de décision. Chaque ADR doit avoir un statut et un journal des modifications contenant la date de modification et le nom de la personne responsable de la modification.

Où puis-je trouver des modèles d'ADR ?

Plusieurs versions et variantes de modèles d'ADR sont disponibles. Pour une collection publique de modèles ADR couramment utilisés, consultez le GitHub référentiel ADR.