lage-chat-control/docs/CONTENT_GUIDE.md

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

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

---
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).

Fiches de référence pour le ton

Six fiches sont réécrites au registre OKI et servent de modèle : signal, protonmail, brave, bitwarden, ublock, quad9. Avant d'écrire ou de réviser une fiche, relis-en deux. Ce qui change par rapport au ton d'origine : tutoiement systématique, le geste avant la technique (« dix secondes, effet immédiat »), l'enjeu politique dit sans détour (« ta correspondance — pas une matière première publicitaire »), et un ancrage collectif (« commence par ton groupe de famille »). Le script de migration ne régénère jamais une fiche existante (--force pour tout écraser) : les réécritures sont protégées.

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.
• Chaque fiche peut avoir sa jumelle créole : content/outils/gcf/<slug>.md (frontmatter minimal : name, slug, lang: "gcf" ; mêmes sections ## what/why/who/install). Elle s'affiche automatiquement quand la personne choisit Kréyòl, avec un bandeau « tradiksyon an chantyé » ; sans jumelle, la version française s'affiche avec un bandeau « póko tradui ». Six jumelles pilotes existent (mêmes slugs que les fiches de référence ci-dessus) — premier jet non relu, à valider avant d'en faire des modèles.
• 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)