docs

Documentation pédagogique d'ai-server, pour des humains : tutoriels et guides pratiques, en tutoiement, ton amical. Rendue en comark dans le cockpit.

Ce dépôt	Ailleurs
Tutoriels, guides, explications	Options de chaque app : cockpit (fiches d'app)
Captures et vidéos (générées)	Référence experte/IA : ai-server/server/docs (EN)

content/fr/
├── _gabarit.md      gabarit d'une page (frontmatter + structure)
├── demarrer/        jour 1 : connexion, double authentification, cockpit
├── guides/          guides existants (n8n, hermes, calrs…), à reclasser
└── serveur/         pages admin, à réécrire en guides pratiques
demo/                VM de démo photographiée par les scénarios
media/               scénarios Playwright + captures validées
.claude/skills/      skills de rédaction et de médias (skills-lock.json)

Écrire une page

Partir de content/fr/_gabarit.md. En bref :

• Tutoiement, courtois et enjoué : une relance par étape (« voilà, ça c'est fait ! »), pas plus.
• Une idée par étape, et ce que le lecteur doit voir à la fin de l'étape.
• Comark : markdown + composants Nuxt UI préfixés u- (::u-alert, ::u-page-grid/:::u-page-card, :u-kbd, ::u-tabs…). Pas de composants « prose » (callout, steps) : le renderer ne les charge pas.
• Pas de # Titre : le title du frontmatter est le H1 et le titre SEO.
• Pas de liste d'options : renvoyer vers la fiche de l'app dans le cockpit.

Plan d'ensemble : PLAN-refonte.md.