Aller au contenu

Contribuer à la documentation

Ce site est construit avec Astro 🡕 et Starlight 🡕. Les pages vivent sous src/content/docs/<lang>/ (fr, en).

Où écrire

doc/<section>.mdx — page d’entrée d’une section : introduction + liens.
doc/<section>/<feuille>.mdx — feuilles de détail.
Sujets transverses courts → doc/how-to/{user,admin,dev}/.

On rédige en français (fr/) ; l’anglais est produit ensuite par just translate. Les slugs et noms de fichiers restent en anglais.

Règles essentielles

Max 7 titres par niveau, profondeur 3.
<Steps> pour les suites d’étapes, <Aside> (avec titre) pour les remarques.
Les Card/CardGrid sont réservées au guide utilisateur.
Voir l’aide & how-to dev et les skills de rôle.

Outils

just dev      # serveur de développement
just tags     # rafraîchit les tags de traduction
just build    # construit le site statique
just test     # tests + validation des liens internes