Workflow documentaire

Capture

Les notes brutes vont dans src/content/docs/inbox/. Elles peuvent etre incompletes, mais doivent conserver le frontmatter obligatoire pour rester visibles et validables dans Starlight.

Transformation

Quand une note devient utile durablement, elle doit etre deplacee vers l’espace adapte :

projects/ pour un projet actif avec livrables ou decisions.
areas/ pour un domaine permanent a maintenir.
resources/ pour une reference reutilisable.
archives/ pour un contenu fige ou historique.

Decisions

Les arbitrages importants doivent etre explicites. Une page qui compare plusieurs options doit contenir une section Decisions ou un composant DecisionBox.

Verification

Avant publication ou partage, lancer les controles suivants :

npm run docs:check
npm run check
npm run build
npm run validate

Le rendu visuel doit aussi etre relu avec npm run dev, surtout pour les documents longs, les tableaux, les composants MDX et les exports PDF.

Sources

Documentation

Astro Starlight

Framework utilise pour produire le site documentaire HTML.

Reference interne

README du projet

Point d'entree pour les commandes, la structure et le deploiement prive.

Prochaines actions

Relire le rendu mobile et desktop
Tepe
A faire
Connecter Cloudflare Pages au repo prive
Tepe
A faire
Activer Cloudflare Access sur le domaine de lecture
Tepe
A faire