ADR 0030 – Site de documentation Astro Starlight et Mermaid
Statut : Décidée. Date : 29/09/2026.
Contexte
Section intitulée « Contexte »CLAUDE.md impose une documentation vivante en français (règles de gestion, ADR, écarts, dictionnaire de données), mise à jour dans le même commit que le code. Il faut un site statique, sans serveur.
Décision
Section intitulée « Décision »apps/docs utilise Astro Starlight (français, barre latérale automatique) et astro-mermaid avec mermaid 11 pour les diagrammes, rendus dans le navigateur.
Alternatives écartées
Section intitulée « Alternatives écartées »Un rendu Mermaid à la construction (rehype-mermaid) demande un navigateur sans interface à l’étape de build. Non retenu pour garder la construction légère.
Conséquences
Section intitulée « Conséquences »Les pages sont du Markdown ; le site est une sortie statique. Dépendances ajoutées : astro, @astrojs/starlight, astro-mermaid, mermaid.
Stratégie de sortie
Section intitulée « Stratégie de sortie »Le contenu reste du Markdown avec front-matter : il se migre vers un autre générateur statique sans réécriture.