Publier des données ouvertes compréhensibles et documentées

Temps de lecture estimé : 3 min · Publié le 1 octobre 2026

Établir provenance et périmètre

Décrivez le producteur, le mode de collecte, la période et la couverture géographique ou thématique. Distinguez date d’extraction, date de mise à jour et période mesurée. Un fichier publié aujourd’hui peut contenir une mesure plus ancienne ; sa date de publication ne transforme pas l’année de référence.

Indiquez les parties manquantes et les valeurs approximatives lorsque la source les identifie. Ne corrigez pas une lacune avec une estimation non signalée. Le guide de documentation de data.gouv.fr insiste sur le contexte de production, la structure et les incohérences possibles.

Fournir un dictionnaire et un exemple

Expliquez chaque champ, son unité, son type, les valeurs absentes et les codes de référence. Prévoyez un petit exemple lisible cohérent avec le fichier complet. Si des identifiants relient plusieurs tables, décrivez la relation et les lignes qui peuvent rester sans correspondance.

Distinguez l’objet de son libellé. Une commune peut avoir plusieurs codes postaux ; un produit peut avoir plusieurs variantes. La documentation doit aider le réutilisateur à éviter une agrégation trompeuse ou une déduplication qui efface une relation utile.

Vérifier la publication et la réutilisation

Identifiez les conditions de réutilisation associées à la source et les informations d’attribution à conserver. Faites vérifier les droits de publication et les données personnelles éventuelles par les personnes compétentes avant de mettre un fichier en accès public. Une adresse déjà visible ailleurs ne rend pas automatiquement toute copie publiable.

Testez le téléchargement sans outil interne ni compte particulier lorsque l’accès annoncé est public. Contrôlez le format, l’encodage et l’intégrité du fichier. Préparez une référence de version ou une empreinte pour pouvoir rapprocher un signalement du fichier effectivement consulté.

Maintenir versions et corrections

Définissez une fréquence de révision réaliste et un contact pour signaler une anomalie. Lorsque le schéma change, décrivez les champs ajoutés, retirés ou redéfinis. Une correction de valeur doit être distinguée d’une nouvelle mesure, afin de ne pas créer une fausse évolution dans une série.

Conservez les versions utiles et leurs notes, avec une politique claire pour les fichiers remplacés. Le dossier de publication devrait permettre à une autre personne de reproduire l’extraction ou, à défaut, de comprendre ses limites. Un compteur de téléchargements ne remplace pas cette qualité documentaire.

Documentation primaire : data.gouv.fr — Bien documenter un jeu de données.

Documents de référence

data.gouv.fr — Bien documenter un jeu de données

Matrice de recette à adapter au projet

Ces contrôles proposés utilisent des cas fictifs. Décidez du comportement attendu avec l’équipe, notez le résultat et attribuez les écarts non résolus avant publication.

Cas de test, résultats attendus et preuves utiles
Cas	Résultat attendu	Preuve à conserver
Téléchargement public annoncé	Une personne extérieure récupère un fichier lisible sans outil interne.	Adresse, format, taille et ouverture avec un lecteur courant.
Champ et unité contrôlés	L’exemple et le fichier complet utilisent la même définition.	Dictionnaire, échantillon et comparaison de valeurs.
Valeur inconnue et identifiant sans correspondance	Les limites sont visibles sans substitution de valeur plausible.	Lignes concernées et règles de représentation de l’inconnu.
Correction publiée	Un utilisateur peut distinguer correction et nouvelle mesure.	Version, description du changement et dates de référence.

Questions fréquentes

Quelle date afficher près du fichier ?

Selon le besoin, affichez date d’extraction, dernière modification et période couverte, en les nommant séparément. Ne présentez pas automatiquement la date de téléchargement comme l’année d’une population ou d’une autre mesure.

Une licence suffit-elle à rendre le jeu exploitable ?

Elle définit des conditions de réutilisation, mais il faut également expliquer champs, unités, identifiants, couverture, qualité et versions. L’usage doit pouvoir être reproduit ou au moins compris par une autre personne.