Formats de contenu

Tu dois ecrire quelque chose. C'est quoi ?

├─ Le lecteur doit APPRENDRE en faisant ?
│  └─ TUTORIEL (pas a pas guide, resultat visible)
│
├─ Le lecteur doit FAIRE une tache precise ?
│  └─ GUIDE PRATIQUE (etapes, pas d'explication)
│
├─ Le lecteur doit COMPRENDRE un concept ?
│  └─ EXPLICATION (pourquoi, pas comment)
│
├─ Le lecteur doit CONSULTER des faits ?
│  └─ REFERENCE (tableau, exhaustif, scannable)
│
├─ Le lecteur doit SUIVRE un cours complet ?
│  └─ COURS (modules, progression, exercices)
│
├─ Le lecteur doit DIAGNOSTIQUER un probleme ?
│  └─ TROUBLESHOOTING (symptome → cause → fix)
│
├─ Le lecteur doit DECIDER entre options ?
│  └─ COMPARAISON (tableau, criteres, verdict)
│
├─ Le lecteur doit CONSULTER un composant / une entite ?
│  └─ FICHE (1 page, 1 sujet, format standardise)
│
├─ Le lecteur doit SAVOIR ce qui a change ?
│  └─ CHANGELOG (version, date, categories)
│
├─ Le lecteur doit INTEGRER une API ?
│  └─ REFERENCE API (endpoints, params, exemples request/response)
│
└─ Pas sur ?
   └─ Commence par une EXPLICATION, puis ajoute les autres

---
title: Creer [resultat] avec [outil]
description: "De zero a [resultat] en [temps]."
human_check: false
---

## Ce que tu vas construire

[1-2 phrases + screenshot/schema du resultat final]

## Prerequis

- [Outil] installe (version X+)
- [Autre prerequis]

## 01 — [Premiere action]

[1 phrase de contexte]

\`\`\`bash
commande ici
\`\`\`

[1-2 phrases expliquant ce qui s'est passe]

## 02 — [Deuxieme action]

[Meme pattern : contexte → code → explication]

## 03 — [Troisieme action]

[...]

## Resultat

[Screenshot ou sortie terminal du resultat]

Tu as maintenant [ce que le lecteur a accompli].

## Lecture liee

- [Guide pratique avance](/lien)
- [Reference complete](/lien)

---
title: [Verbe] [objet]
description: "[Verbe] [objet] en [nombre] etapes."
human_check: false
---

[1 phrase : ce que tu vas faire et pourquoi.]

## Prerequis

- [Prerequis 1]

## [Verbe] [objet]

\`\`\`bash
commande
\`\`\`

[1 phrase de contexte si necessaire]

## Verifier

[Comment confirmer que ca a marche]

## Troubleshooting

| Symptome | Cause | Fix |
|----------|-------|-----|
| [Erreur] | [Raison] | [Solution] |

---
title: [Concept] — pourquoi et comment ca marche
description: "[Concept] explique. Pourquoi [choix], comment [mecanisme], quand [utiliser]."
human_check: false
---

## Le probleme

[Quel probleme ce concept resout]

## La solution

[Comment ca marche, en termes simples]

## Pourquoi ce choix

[Alternatives considerees, tradeoffs, decision]

| Approche | Avantage | Inconvenient |
|----------|----------|--------------|
| Option A | ... | ... |
| Option B | ... | ... |

## En pratique

[Exemple concret qui illustre le concept]

## Ce qu'il faut retenir

[3-5 bullet points]

---
title: Reference [sujet]
description: "Liste complete des [elements]. [Nombre] entrees."
human_check: false
---

[1 phrase d'intro + nombre total d'elements]

## [Categorie 1]

| Nom | Description | Valeur par defaut |
|-----|-------------|-------------------|
| ... | ... | ... |

## [Categorie 2]

| ... | ... | ... |

cours-[sujet]/
├── index.mdx                # Vue d'ensemble + prerequis + plan par module
├── 01-[fondation].mdx       # Concepts de base
├── 02-[pratique].mdx        # Premiere mise en pratique
├── 03-[avance].mdx          # Concepts avances
├── 04-[projet].mdx          # Projet complet
└── 05-cheatsheet.mdx        # Aide-memoire (fichier supplementaire, pas un module)

## Plan du cours

| Module | Titre | Temps | Prerequis |
|--------|-------|-------|-----------|
| 01 | [Fondation] | 15 min | Aucun |
| 02 | [Pratique] | 20 min | Module 01 |
| 03 | [Avance] | 25 min | Module 02 |
| 04 | [Projet] | 30 min | Modules 01-03 |

### Exercice : [titre]

**Consigne :** [ce que le lecteur doit faire]

**Resultat attendu :** [ce qu'il doit obtenir]

<Accordion title="Solution">
[code ou explication de la solution]
</Accordion>

---
title: Resoudre [categorie de problemes]
description: "Diagnostic et solutions pour les problemes courants de [sujet]."
human_check: false
---

## [Symptome 1]

**Cause :** [Explication en 1 phrase]

**Fix :**

\`\`\`bash
commande de fix
\`\`\`

## [Symptome 2]

[Meme pattern]

---
title: "[Option A] vs [Option B]"
description: "Comparaison de [A] et [B]. Criteres, forces, faiblesses, verdict."
human_check: false
---

## Resume

| Critere | [A] | [B] |
|---------|-----|-----|
| [Critere 1] | ... | ... |
| [Critere 2] | ... | ... |

## [Option A] en detail

[Forces, faiblesses, cas d'usage ideal]

## [Option B] en detail

[Forces, faiblesses, cas d'usage ideal]

## Verdict

Utilise [A] si [condition]. Utilise [B] si [condition].

---
title: [Nom de l'element]
description: "[Role en 1 phrase]."
human_check: false
---

**Role :** [1 phrase]
**Categorie :** [Couche/domaine]

## Declenchement

| Trigger | Frequence |
|---------|-----------|
| ... | ... |

## Sources

| Source | Donnees |
|--------|---------|
| ... | ... |

## Actions

[Liste des actions]

## Outputs

| Output | Destination | Format |
|--------|-------------|--------|
| ... | ... | ... |

---
title: Changelog
description: "Historique des modifications du systeme."
human_check: false
---

## [version] — YYYY-MM-DD

### Ajoute
- [Description courte]

### Modifie
- [Description courte]

### Supprime
- [Description courte]

### Corrige
- [Description courte]

---
title: API [nom du service]
description: "Reference complete de l'API [nom]. [Nombre] endpoints."
human_check: false
---

## Base URL

\`\`\`text
https://api.example.com/v1
\`\`\`

## Authentification

\`\`\`bash
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.example.com/v1/resource
\`\`\`

## [Domaine 1]

### [Methode] /endpoint

[1 phrase de description]

**Parametres :**

| Nom | Type | Requis | Description | Defaut |
|-----|------|--------|-------------|--------|
| id | string | Oui | Identifiant unique | — |
| limit | integer | Non | Nombre de resultats | 20 |

**Exemple request :**

\`\`\`bash
curl -X GET "https://api.example.com/v1/endpoint?limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"
\`\`\`

**Exemple response :**

\`\`\`json
{
  "data": [],
  "meta": { "total": 0 }
}
\`\`\`

**Codes erreur :**

| Code | Description |
|------|-------------|
| 200 | Succes |
| 401 | Token invalide ou manquant |
| 404 | Ressource introuvable |
| 429 | Rate limit depasse |