Qu'est-ce que arc42 ?
arc42, créé par Peter Hruschka et Gernot Starke, structure la documentation d'architecture en douze sections : introduction et objectifs, contraintes, contexte et périmètre, stratégie de solution, vue en briques, vue d'exécution, vue de déploiement, concepts transversaux, décisions d'architecture, exigences de qualité, risques et dette technique, et glossaire. Il n'impose aucune notation de diagramme, si bien que les équipes y dessinent souvent des diagrammes C4 : le diagramme de contexte en section 3, les diagrammes de conteneurs et de composants dans la vue en briques (section 5), et les diagrammes dynamiques dans la vue d'exécution (section 6). Sa propre recommandation est de ne documenter que ce dont les lecteurs ont besoin plutôt que de remplir chaque section.
Également appelé : arc42 template.
Termes associés
- Modèle C4 — Une approche légère de visualisation de l'architecture qui décrit les systèmes logiciels à travers quatre niveaux : Contexte système, Conteneur, Composant et Code.
- Architecture Decision Record (ADR) — Un court document capturant une décision architecturalement significative, son contexte et ses conséquences.
- Documentation vivante — Une documentation générée ou validée à partir du système en fonctionnement, afin qu'elle reste exacte à mesure que le système évolue.