| name | redaction-methodologie |
| description | Rédiger ou réviser la page Méthodologie PUBLIQUE (public/methodologie/index.html) au bon registre : pour le grand public, transparente et scientifique, mais SANS jargon interne (noms de raffineurs, de tables, de colonnes) ni détails qui exposeraient la propriété intellectuelle ou les droits des médias. À utiliser dès qu'on écrit, simplifie ou révise une section de la métho, ou qu'un passage est jugé « trop technique », « trop interne » ou « pas pour le public ». Complète synchro-methodologie (qui dit QUOI/QUAND mettre à jour ; celui-ci dit COMMENT l'écrire). Déclencheurs : « rédige la métho », « simplifie la métho », « c'est trop technique », « vulgarise cette section », « la métho parle aux devs ».
|
Rédaction de la page Méthodologie (registre public)
La page Méthodologie est le contrat public du projet. Elle est lue par le
grand public sur le site Web. Ce n'est PAS la documentation d'équipe. Elle
doit être transparente, complète et scientifique, mais écrite pour des gens
qui ne connaissent ni le code ni l'infrastructure.
Le principe central : deux registres à ne jamais confondre
| Doc d'ÉQUIPE (interne) | Page MÉTHO (publique) |
|---|
Noms de raffineurs (radar-event-salience), de tables (headline_events_4h), de colonnes (score_qc, storyline_id, media_ids_24h) | Ce que le système fait, en français clair |
| Détails d'implémentation, chemins, workflows, blocs techniques | Le principe et la logique, pas la plomberie |
| Vise la reproduction du code | Vise la compréhension et la confiance du lecteur |
Règle d'or : si une phrase ne parle qu'aux développeurs, elle n'a pas sa place
dans la métho. On décrit le comportement, jamais le composant.
Ce qu'on MONTRE (transparence + reproductibilité scientifique)
- Les sources : quels médias, quelle période, quelle fréquence de collecte.
- Les concepts et définitions (saillance, divergence, dimensions, niveaux).
- La logique des calculs et des seuils, en mots — assez pour qu'un chercheur
comprenne et puisse discuter la démarche.
- Les limites connues et les choix assumés.
Ce qu'on NE montre PAS
- Les noms internes : raffineurs, tables, colonnes, workflows, chemins.
- Le détail exact qui permettrait de copier la recette (protection de la
propriété intellectuelle). On explique la démarche, pas la formule ligne à ligne.
- Le texte intégral des articles de médias : toujours renvoyer au site du
média pour la lecture (respect des droits et des données des médias).
Registre d'écriture
- Français clair, phrases simples, ton scientifique mais accessible.
- Nommer les choses par leur sens, pas par leur nom de code.
- Objectif double : un lecteur non technique comprend tout ; un chercheur trouve
l'information méthodologique dont il a besoin pour évaluer la démarche.
Exemples (avant → après)
-
❌ « Le raffineur radar-event-salience produit la table headline_events_4h
avec score_saillance et score_qc. »
✅ « Le système regroupe les articles qui traitent du même événement et lui
attribue un score de saillance — son importance médiatique — calculé
globalement et spécifiquement pour le Québec. »
-
❌ « Suit chaque histoire par storyline_id d'un bloc de 4 h à l'autre et
agrège media_ids_24h. »
✅ « Le système suit chaque nouvelle au fil de la journée et rassemble, sur
24 heures, l'ensemble des médias qui l'ont mise en Une. »
Procédure
- Repérer la ou les sections concernées (mapping section ↔ comportement réel :
voir synchro-methodologie).
- Vérifier que le contenu est vrai et actuel (le comportement réel du
système, pas une intention — cf. FAIT vs VISION).
- Réécrire au registre public : retirer tout nom interne, garder le sens.
- Vérifier qu'aucun détail ne compromet la PI ni les droits des médias
(et qu'on renvoie bien au site du média pour les textes).
- Vérifier le rendu en preview (HTML statique).
Rappels
- La métho est du HTML statique (
public/methodologie/index.html) — éditer
directement, vérifier en preview (le reporter React n'y tourne pas).
- Deux skills complémentaires :
synchro-methodologie (quoi/quand mettre à
jour, véracité vs le code) et celui-ci (comment l'écrire pour le public).
Les employer ensemble : synchro garantit que c'est vrai, rédaction
garantit que c'est lisible et approprié.
- Ne jamais introduire un nom de raffineur, de table ou de colonne dans la
métho.
