Gouvernance documentaire

Niveaux d’autorité

1. comportement exécutable canonique ;
2. commentaires de spécification ;
3. README ;
4. documentation MDX ;
5. ADR pour les décisions historiques ;
6. code production lorsqu’il atteint la parité.

Statuts de contenu

Une page doit clairement distinguer :

• Canonique — invariant actuel ;
• Draft — contrat proposé ;
• Planifié — roadmap ;
• Référence fournisseur — information à revalider.

Revue périodique

Tous les trimestres :

• vérifier liens externes ;
• revalider fournisseurs/versions/pricing ;
• archiver pages obsolètes ;
• vérifier exemples API ;
• revoir threat model ;
• vérifier que le prototype et la production n’ont pas divergé.

Ownership

Chaque domaine majeur doit avoir un owner explicite à mesure que l’équipe grandit.

Historique

Ne pas réécrire l’histoire des décisions : utiliser changelog + ADR.