Qu'est-ce que Documentation vivante ?
La documentation vivante, introduite par Cyrille Martraire, rejette le postulat selon lequel les docs sont condamnées à pourrir. L'idée : traiter la documentation comme une sortie de la base de code (extraite, générée ou continuellement validée) plutôt que comme un artefact parallèle que quelqu'un doit penser à mettre à jour. Les modèles C4 découverts depuis le code et les règles de conformité appliquées en CI sont deux incarnations de cette idée.
Termes associés
- Architecture as Code — Décrire l'architecture d'un système dans un format texte versionné afin de pouvoir la relire, la comparer et la valider comme du code source.
- Dérive d'architecture — L'écart qui se creuse entre l'architecture documentée et le système qui tourne réellement en production.
- Serveur MCP — Un serveur implémentant le Model Context Protocol afin que les assistants de code IA puissent interroger le contexte d'un projet via une interface d'outils standardisée.