Arrêté à quand, depuis quoi, et à quelle fréquence

Les trois questions

Elles arrivent dans cet ordre, de quelqu’un qui vous fait confiance et doit défendre le nombre devant quelqu’un qui ne vous la fait pas.

« Arrêté à quand ? » Un chiffre de couverture sans date est un chiffre qui sera cité en mars prochain.

« Depuis quoi ? » Quel export, quelle version, quelle extraction de la base — et si c’est le même que celui du rapport précédent.

« À quelle fréquence change-t-il ? » Si le nombre devant eux date de ce matin ou du trimestre dernier, et si revenir voir la semaine prochaine vaut la peine.

Répondez aux trois sur la page. Chacune fait une ligne, et l’alternative est d’y répondre onze fois par courriel.

À quoi ressemblent les réponses

  Source: wash-household-survey-2024.v1.csv
  Data as of: 2024-11-30 (survey round 1)
  Refreshed: when a new survey round is published; this is a single round

Nommez le fichier, non le système. « Depuis DHIS2 » dit d’où cela vient ; le nom et la version de l’export sont ce que quelqu’un peut aller chercher.

Versionnez par le nom de fichier. .v1.csv est ce qui rend « le même fichier que le rapport de mars » vérifiable. Une correction est livrée en .v2 et n’écrase jamais, règle que suivent les jeux de données de cette plateforme et raison pour laquelle un carnet accroché à la v1 continue de reproduire.

Distinguez la date des données de la date de compilation. Elles diffèrent et une seule intéresse le lecteur.

	Signifie	Sur la page ?
Données arrêtées au	La dernière observation du fichier	Oui, bien en vue
Date d’extraction	Quand l’export a été tiré	Si elles diffèrent sensiblement
Date de compilation	Quand le HTML a été écrit	Non

La date de compilation est celle que tout le monde met et dont personne n’a besoin. Elle change à chaque reconstruction, n’apprend rien sur les données, et — comme l’a établi le cours sur les chaînes reproductibles — rend la sortie non déterministe, si bien qu’un diff cesse de signifier quoi que ce soit.

Aucun des sept tableaux de bord d’ici ne porte de date de production, et c’est pourquoi les reconstruire produit des fichiers identiques à l’octet près.

L’actualisation, énoncée comme une cadence et un responsable

  Refreshed monthly, on the 5th, from the screening database export.
  Owner: the M&E officer. If the export has not arrived by the 10th, the
  page still shows the previous month and says so.

Une cadence sans responsable est un vœu. La ligne utile nomme qui le fait et ce qui se passe quand cela n’est pas fait.

Dites à quoi ressemble une page périmée. Le mode d’échec est un tableau de bord montrant silencieusement le mois dernier pendant que tout le monde le croit à jour. Une page qui énonce sa date de données rend la péremption visible sans aucune machinerie.

La complétude va à côté du nombre

C’est la question de provenance que ce secteur a et que d’autres n’ont pas.

submitted = reports[reports["report_submitted"]].shape[0]
print(f"reporting completeness: {submitted / len(reports):.1%}")

mean(reports$report_submitted)

Un chiffre de couverture calculé depuis 76 % des formations sanitaires est un autre nombre que celui calculé depuis 99 %, et le cours d’épidémiologie a consacré une leçon à un mois où la complétude est tombée à 28,9 % et le nombre de cas avec elle.

La complétude va donc sur la page, à côté de tout indicateur dont le dénominateur dépend de qui a rapporté. Le tableau de bord vaccination d’ici la porte comme une tuile pour exactement cette raison.

Et un mois sans rapports est tracé comme un trou, jamais comme un zéro. Zéro est une affirmation que rien ne s’est passé.

Ce qu’énoncent les tableaux de bord de la plateforme

  Source: protection-referrals-2024.v1.csv
  How these numbers are produced: computed from the committed dataset file
  named above by scripts/export/build-project-dashboards.mjs. Nothing is
  typed by hand and the page contains no script, no external request and no
  generation date, so rebuilding it on unchanged data produces an identical
  file.

La dernière proposition est la plus forte affirmation de provenance disponible, et elle est vérifiable par quiconque a le dépôt : reconstruisez, et git status est vide.

« Rien n’est saisi à la main » est la partie qui compte pour un relecteur. Un nombre saisi dans une légende peut dériver du graphique au-dessus, et rien ne le détecte — c’est l’échec que la dernière leçon du cours de visualisation existe pour prévenir.

Là où la provenance est mince, dites-le

Trois cas, et les nommer vaut mieux que l’alternative.

Un nombre venant d’une autre agence. « 4W du cluster, soumission de février » est une provenance ; « données du cluster » non. Si vous ne pouvez pas le versionner, dites quand vous l’avez reçu et de qui.

Un dénominateur issu d’une projection. Les chiffres de population sont généralement projetés depuis un recensement, et l’année de base de la projection est la provenance dont un lecteur a besoin. Le taux brut de scolarisation de 109,2 % du cours d’éducation est une histoire de dénominateur, non d’inscription.

Un nombre que quelqu’un a ajusté. Si l’entrée manifestement fausse d’une formation sanitaire a été corrigée avant analyse, c’est une décision et elle a sa place dans la documentation technique, la page pointant vers elle.

Rapportez-le en entier

Provenance panel

  Source            wash-household-survey-2024.v1.csv
                    2,403 households, 18 communities, 3 districts
  Data as of        2024-11-30, survey round 1
  Refresh           single round; no monthly cadence. A second round is
                    planned for 2025 and will make a trend meaningful.
  Completeness      water quality tested on 33.4% of households; every
                    quality figure states that denominator separately
  Produced by       scripts/export/build-project-dashboards.mjs, from the
                    committed file. No hand-entered numbers, no generation
                    date, byte-identical on rebuild.
  Definitions       docs/indicator-definitions.md

La dernière ligne est le passage de relais vers la leçon suivante. Un panneau de provenance dit d’où vient le nombre ; un panneau de définitions dit ce qu’il est, et les deux ensemble sont ce qui empêche la même dispute de revenir chaque mois.

La suite

Deux artefacts de cette plateforme ont calculé la couverture en eau améliorée depuis le même fichier et obtenu des réponses différentes. La leçon suivante porte sur le panneau qui l’aurait attrapé — et sur le fait qu’il l’a attrapé.