La documentation d’architecture versionnée avec le code (la structure Arc42 pour le récit, le modèle C4 pour les diagrammes), revue par le même flux de pull requests. Dans mes dépôts, les ADR vivent à côté du source et le workspace C4 est poussé vers Structurizr par la même CI qui livre le code. Ça garde la doc honnête : elle évolue avec le système au lieu de pourrir dans un wiki, et c’est ce qui fait qu’on s’y fie vraiment.
Docs-as-Code (Arc42 + modèle C4) en Adopt — Confirmé par une pratique réelle ; mon choix par défaut dans le bon contexte.
Trajectoire
- AdoptPremière apparition