Files

T

OKIandClaude Opus 5 9e3c176411 feat(participatif): publier les manques et outiller la contribution

Le manque devient une information de première classe : mesuré, daté,
affiché, et accompagné de la marche à suivre pour le combler (ADR 0006).

Mesure
- rapport:manques : couverture des 5 vues pédagogiques dans les fonds
  publics, présence du kréyòl sur Wikidata, observations GBIF par île,
  manques internes du dataset → docs/manques.md.
- Le kréyòl est absent des communs : Wikidata enregistre 124 noms
  vernaculaires pour ces 13 espèces (zh, en, pt, sl) et aucun en kréyòl ;
  0 étiquette gcf sur 13 items.
- L'écorce est la vue manquante : 3 trous sur 65, tous des écorces —
  mansiniyé 0 fichier, aki 0, kénèt 1.
- Pl@ntNet publie en CC BY-SA là où iNaturalist est à ~93 % CC BY-NC :
  meilleur canal de contribution à effort égal.

Correction d'une mesure fausse avant publication
- Le premier rapport annonçait 28 vues manquantes sur 65. Le groupement OR
  de la recherche Commons ne se comporte pas comme attendu : « section »
  seul remonte 17 fichiers là où « (section OR sliced OR cut OR coupe) » en
  remonte 0. Un mot, une requête, avec gestion du débit — le chiffre réel
  est 3 sur 65. Publier les 28 aurait envoyé des bénévoles photographier
  ce qui existait déjà.

Documents
- docs/contribuer.md : six gestes, du nom kréyòl sur Wikidata (5 min) à
  l'enregistrement d'une voix, avec le tableau de choix de licence et la
  consigne de sécurité pour photographier le mancenillier.
- docs/adr/0006-projet-participatif.md : aucun dépôt interne, aucune
  requête tierce au runtime, la porte de validation reste inchangée.
- docs/courriers/appel-liberation-tramil.md : brouillon d'appel public,
  à n'envisager qu'après la demande privée. Publication au porteur.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-07-27 10:12:35 -04:00

5.1 KiB

Raw Blame History

ADR 0006 — Le manque est publié, pas masqué

Statut : accepté
Date : 2026-07-27
Session : 0 — cadre et données
Décideur : le porteur

Contexte

Le projet se heurtait à un mur prévisible : les fonds libres documentent mal la flore antillaise, et le premier réflexe d'un projet logiciel devant un trou de données est de le contourner — masquer la fiche incomplète, remplacer la photo absente par un visuel généré, afficher une saison approximative sans le dire.

Chacun de ces contournements dégrade ce que le jeu prétend enseigner, et surtout : il perd l'information. Un trou masqué reste un trou. Un trou publié est une tâche que quelqu'un peut prendre.

La mesure faite en session 0 donne à cette question un poids inattendu. Wikidata enregistre 124 noms vernaculaires pour les 13 espèces du projet — 33 pour le fruit à pain, 22 pour la pomme d'eau, en chinois, anglais, portugais, slovène. Aucun en kréyòl. Le jeu n'est donc pas seulement consommateur de communs numériques : il est, sur cette langue, à peu près le seul à en produire.

Décision

Le manque est une information de première classe, affichée dans le produit.

Trois conséquences concrètes

L'encyclopédie affiche ce qu'elle n'a pas. Une fiche sans photo d'écorce le dit, et explique comment la combler. Pas de silence, pas de remplissage.
Le jeu comporte un écran de contribution — « Ba on koudmen » — qui liste les manques du moment et pointe vers les plateformes où les combler. Session 2.
Le manque est mesuré par script, pas décrit à la main. npm run rapport:manques produit docs/manques.md : couverture des cinq vues pédagogiques dans les fonds publics, présence du kréyòl sur Wikidata, observations par île, et manques internes du dataset. Un chiffre daté vaut mieux qu'une impression.

Ce que cette décision n'autorise pas

Aucune requête tierce au runtime. Contribuer se fait sur les plateformes externes ; le jeu se contente de liens <a> ordinaires. Le rapport de manques est calculé au build (playbook P2) et embarqué comme donnée statique. Aucun appel à Commons, Wikidata, iNaturalist ou Pl@ntNet pendant qu'on joue.
Aucun compte, aucune collecte. Le projet ne reçoit pas les contributions : il oriente vers Commons et Wikidata, où elles profitent à tout le monde. Un formulaire de dépôt interne créerait un silo, exactement ce que le projet combat, et poserait la question de la modération de contenus déposés par des enfants — que ce projet ne veut pas avoir à se poser.
Aucun assouplissement de la porte de validation. Une contribution passe par la même relecture humaine nominative que le reste (ADR 0004). L'ouverture porte sur qui peut proposer, jamais sur qui peut valider.

Conséquences

Sur les priorités de contenu

La mesure fait apparaître une hiérarchie que l'intuition n'aurait pas donnée :

L'écorce est la vue manquante — 3 trous sur les 3 restants après correction de la mesure, tous des écorces. C'est aussi l'indice le plus fiable sur le terrain, puisqu'un tronc est visible toute l'année quand un fruit ne l'est que quelques mois.
Le mancenillier est le plus mal servi : 56 fichiers sur Commons contre 1076 pour la goyave, ses trois premiers résultats étant des gravures de 1780, 1816 et 1821. L'entrée la plus critique du module de sécurité est la moins bien documentée.
Le kréyòl est à zéro partout, ce qui rend la contribution Wikidata prioritaire alors qu'elle ne demande ni appareil photo ni déplacement.

Sur les sessions suivantes

Session 1 — l'encyclopédie affiche les manques de chaque fiche.
Session 2 — écran « Ba on koudmen », alimenté par le rapport baké au build.
Session 6 — docs/contribuer.md devient une page publique du site.

Sur la mesure elle-même

Le premier rapport produit annonçait 28 vues manquantes sur 65. Le chiffre était faux : le groupement OR de la recherche Commons ne se comporte pas comme attendu — sur Annona muricata, section seul remonte 17 fichiers là où (section OR sliced OR cut OR coupe) en remonte 0. Après correction — un mot, une requête —, le chiffre réel est 3 sur 65.

L'écart est instructif à deux titres. D'abord, publier 28 faux manques aurait envoyé des bénévoles photographier ce qui existait déjà. Ensuite, une mesure qui produit un résultat extrême — ici, coupe à zéro pour les treize espèces — doit être suspectée avant d'être publiée. Le script gère désormais explicitement la limitation de débit des API, parce qu'une réponse illisible comptée comme « 0 fichier » fabrique un manque imaginaire.

Alternative écartée

Un formulaire de dépôt de photos dans le jeu. Plus simple pour le contributeur, mais il crée un silo — les photos ne serviraient qu'à ce jeu —, impose une modération, et suppose un serveur, un compte et une collecte. Orienter vers Commons demande un effort de plus au contributeur et rend sa contribution utile bien au-delà du projet. C'est le sens même du mot « communs ».

5.1 KiB Raw Blame History