# Guide de rédaction — fiches d'outils FR/créole

## Format d'une fiche (`content/outils/<slug>.md`)

```markdown
---
name: "Signal"
slug: "signal"
category: "messagerie"        # slug d'une catégorie de content/categories.json
difficulty: "beginner"        # beginner | intermediate | advanced
license: "AGPL-3.0"           # identifiant SPDX exact (spdx.org/licenses)
url: "https://signal.org"
color: "#3a76f0"              # couleur du monogramme (décorative)
monogram: "S"
tags: ["Remplace WhatsApp","🇺🇸 · open-source"]
lang: "fr"
---

## what
À quoi sert l'outil, en deux phrases maximum.

## why
Pourquoi il compte pour la souveraineté numérique.

## who
Pour qui, et à quel moment du parcours.

## install
<ol><li>Étapes concrètes, numérotées.</li></ol>
```

Les valeurs du frontmatter sont encodées en JSON (guillemets doubles).
Le corps accepte Markdown et HTML simple ; il est rendu au build, rien n'est
interprété côté client. **Le build échoue si une fiche est invalide** — c'est
le contrat de validation (ADR-001).

## Ton éditorial

- **Militant mais chaleureux, ancré Caraïbe.** Pas de langage corporate, pas
  de peur gratuite : on explique le geste, on donne le pouvoir d'agir.
- Tutoiement. Phrases courtes. Le premier mot de chaque section porte le sens
  (motif en F, doctrine §1.1).
- `what` dit le service rendu, `why` dit l'enjeu politique/technique, `who`
  donne la porte d'entrée (« commence ici si… »), `install` est actionnable
  sans autre lecture.
- Exemples et localisation ancrés territoire — jamais de Lorem ipsum
  hexagonal (doctrine §4.2).

## Créole guadeloupéen (gcf)

- Les **micro-textes de l'interface** (boutons, filtres, états vides, marqueur
  de fin) vivent dans `frontend/src/lib/i18n/gcf.json`. C'est la couche à
  plus fort impact affectif pour le plus faible coût (doctrine §4.2) — elle
  est traduite en premier.
- ⚠️ **Relecture par un locuteur natif requise** : les chaînes gcf actuelles
  sont un premier jet à valider avant mise en production. La graphie de
  référence à trancher (GEREC-F ou autre) doit être notée ici une fois choisie.
- La traduction intégrale des fiches est un chantier éditorial séparé :
  le format prévu est un fichier jumeau `content/outils/gcf/<slug>.md` avec
  `lang: "gcf"` (le chargeur l'ignorera tant que la locale de contenu n'est
  pas activée).
- Termes fixés : « zouti » (outil), « Ou pa manké ayen » (fin de liste),
  « Chwazi zouti ou » (héros), niveaux « Débitan / Entèmédia / Avansé ».

## Ajouter une catégorie

Ajouter une entrée à `content/categories.json` (`slug`, `title`, `order`,
`part`). La navigation n'affiche que 4 catégories avant la divulgation
progressive (Hick-Hyman, doctrine §1.3) : l'ordre `order` décide lesquelles.

## Vérifications avant merge

- [ ] `license` est un identifiant SPDX valide
- [ ] `difficulty` reflète l'expérience réelle d'installation (pas le prestige)
- [ ] Chaque section respecte sa question (what/why/who/install)
- [ ] `pnpm build` passe (validation du frontmatter incluse)