Temps de lecture estimé : 5 min · Publié le
É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.
Pour un jeu géographique, documentez le référentiel et l’ordre des coordonnées, pas seulement le nom du format. La RFC 7946 définit GeoJSON avec WGS 84 et des degrés décimaux ; les deux premières valeurs d’une position sont longitude puis latitude. Dans un exercice fictif, le Point de coordonnées [2.35,48.86] ne doit donc pas devenir [48.86,2.35]. Les deux tableaux sont lisibles en JSON et les valeurs restent plausibles : la seule validation syntaxique ne détecte pas cette inversion.
Distinguez une entité non localisée d’un point connu. Dans une Feature GeoJSON non localisée, geometry peut valoir null ; cela ne revient pas à écrire un Point avec des coordonnées nulles, ni à remplacer l’inconnu par [0,0], qui désigne une position réelle. Décrivez aussi ce que le point représente : entrée observée, adresse géocodée ou centre calculé, avec provenance et date. Ajouter des décimales ne rend pas une estimation plus certaine.
Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.
| Cas | Interprétation | Contrôle utile |
|---|---|---|
| Point · coordinates: [2.35,48.86] | Longitude 2.35 ; latitude 48.86 | Comparer avec les champs nommés de la source |
| Point · coordinates: [48.86,2.35] | Deux nombres plausibles, ordre inversé dans cet exercice | Contrôler le sens ; la syntaxe seule ne suffit pas |
| Feature · geometry: null | Entité non localisée ; fragment de structure | Documenter la valeur absente sans inventer un point |
| Position [0,0] | Coordonnées existantes, pas une absence | Ne pas utiliser comme remplacement automatique de l’inconnu |
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.
Distinguez le jeu de données de ses distributions. Un CSV et un JSON peuvent représenter le même jeu dans deux formats ; ne les comptez pas automatiquement comme deux mesures indépendantes. DCAT décrit une distribution comme une représentation particulière d’un jeu. Comparez toutefois couverture, précision, champs et version : deux distributions ne sont pas nécessairement équivalentes sans perte d’information.
Ajoutez un identifiant de version et un historique expliquant la correction. Une adresse « dernière version » peut rester stable, mais il faut pouvoir identifier la version effectivement utilisée. Distinguez aussi correction et nouvelle observation : une mesure portant sur un nouveau mois ne corrige pas, par sa seule existence, la mesure du mois précédent. Décrivez ce rapport entre versions et séries avant de comparer les chiffres.
Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.
| Repère documentaire | Ce qu’il distingue | Vérification utile |
|---|---|---|
| Jeu de données | Le sujet, le périmètre et les observations décrites. | L’identité reste compréhensible indépendamment du format de fichier. |
| Distribution CSV ou JSON | Une représentation particulière du jeu. | Comparer champs, précision et couverture avant de supposer leur équivalence. |
| Version identifiée | Un état précis et son historique de changements. | Retrouver la version citée, même si une adresse courante a été actualisée. |
| Correction ou nouvelle période | Révision d’une donnée ou observation différente. | Ne pas présenter un nouveau mois comme la correction automatique du précédent. |
- W3C DCAT 3 : Distributions
Consulté le 22 octobre 2026 ; distinction entre jeu de données et représentations, avec d’éventuelles différences de fidélité.
- W3C : Données sur le Web et versions
Consulté le 22 octobre 2026 ; identifiant de version, historique et distinction avec des observations de périodes différentes.
Documents de référence
- W3C : Data on the Web Best Practices · Source consultée
- IETF : GeoJSON RFC 7946 · Source consultée
- data.gouv.fr : Bien documenter un jeu de données
Contenu mis à jour le
Repères documentaires pour ce sujet
| Référence | Valeur ou syntaxe | Portée du repère |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | Les champs avec virgule, guillemet ou saut de ligne sont protégés ; les guillemets internes sont doublés. |
| RFC 8259 · JSON | application/json · UTF-8 | JSON standard n’autorise ni commentaires ni virgule finale ; les chaînes utilisent des guillemets doubles. |
Les dates indiquent la consultation des références. Ces repères ne constituent ni un audit du site ni une déclaration globale de conformité.
