Tempo di lettura stimato : 5 min · Pubblicato
Stabilire provenienza e portata
Descrivere il produttore, il metodo di raccolta, il periodo di tempo e la copertura geografica o tematica. distinguere le date di estrazione, aggiornamento e misurazione. Un file pubblicato oggi può descrivere una misurazione precedente; La pubblicazione non cambia l'anno di riferimento.
Indica le aree mancanti e i valori approssimativi in cui la fonte le identifica. Non colmare una lacuna con una stima non rivelata. La guida alla documentazione di data.gouv.fr affronta il contesto di produzione, la struttura e le possibili incongruenze.
Fornisci un dizionario e un esempio
Spiega ogni campo, unità, tipo, valore mancante e codice di riferimento. Fornire un piccolo esempio leggibile coerente con il set di dati completo. dove gli identificatori si uniscono a tabelle, relazioni di documenti e righe potenzialmente impareggiabili.
distinguere le entità dalle loro etichette. Un comune può avere diversi codici postali e un prodotto diverse varianti. La documentazione dovrebbe aiutare a prevenire l'aggregazione o la deduplicazione ingannevole che rimuova una relazione utile.
Per dati geografici documentare riferimento e ordine delle coordinate, non solo il formato. RFC 7946 definisce GeoJSON con WGS 84 e gradi decimali; i primi due valori sono longitudine e latitudine. Nell’esercizio fittizio, Point [2.35,48.86] non deve diventare [48.86,2.35]. Entrambi gli array sono JSON leggibile con numeri plausibili: la sola verifica sintattica non rileva lo scambio.
Distinguere un’entità non localizzata da un punto noto. In una Feature GeoJSON non localizzata geometry può essere null; non equivale a un Point con coordinate nulle né a sostituire un valore ignoto con [0,0], una posizione reale. Descrivere inoltre ingresso osservato, indirizzo geocodificato o centro calcolato, con provenienza e data. Aggiungere decimali non rende più certa una stima.
Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.
| Caso | Interpretazione | Controllo utile |
|---|---|---|
| Point · coordinates: [2.35,48.86] | Longitudine 2.35; latitudine 48.86 | Confrontare con i campi nominati della fonte |
| Point · coordinates: [48.86,2.35] | Numeri plausibili, invertiti nell’esercizio | Controllare il significato; la sintassi non basta |
| Feature · geometry: null | Entità non localizzata; frammento di struttura | Documentare l’assenza senza inventare un punto |
| Posizione [0,0] | Coordinate esistenti, non assenza | Non sostituire automaticamente un dato ignoto |
Controlla la pubblicazione e il riutilizzo
Identificare le condizioni di riutilizzo della fonte e le informazioni sull'attribuzione da conservare. Chiedi ai revisori appropriati di valutare i diritti di pubblicazione e i possibili dati personali prima del rilascio pubblico. Un indirizzo visibile altrove non rende automaticamente ogni copia adatta alla pubblicazione.
Testare i download senza strumenti interni o account speciali quando è promesso l'accesso pubblico. Controlla il formato, la codifica e l'integrità. Fornire un riferimento alla versione o un checksum in modo che il feedback possa essere legato al file scaricato.
Mantieni versioni e correzioni
Scegli una frequenza di revisione realistica e un contatto per i problemi. Descrivi campi aggiunti, rimossi o ridefiniti quando gli schemi cambiano. Distinguere le correzioni dalle nuove misurazioni per evitare di creare falsi cambiamenti in una serie temporale.
Conserva versioni e note utili con una chiara politica di sostituzione. La documentazione di pubblicazione dovrebbe consentire a un'altra persona di riprodurre l'estrazione o comprendere i suoi limiti. Un contatore di download non sostituisce la qualità della documentazione.
Documentazione primaria: data.gouv.fr : Bien documenter un jeu de données.
Distinguete il dataset dalle sue distribuzioni. Un CSV e un JSON possono rappresentare lo stesso dataset in due formati; non contateli automaticamente come due misurazioni indipendenti. DCAT descrive una distribuzione come una rappresentazione specifica del dataset. Confrontate comunque copertura, precisione, campi e versione: due distribuzioni non sono necessariamente equivalenti senza perdita d’informazione.
Aggiungete un identificatore di versione e una cronologia delle correzioni. Un indirizzo «ultima versione» può restare stabile, ma occorre poter identificare quella effettivamente usata. Distinguete anche correzione e nuova osservazione: misurare un nuovo mese non corregge da solo il precedente. Spiegate il rapporto tra versioni e serie prima di confrontare i numeri.
Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.
| Elemento documentale | Cosa distingue | Controllo utile |
|---|---|---|
| Dataset | Argomento, ambito e osservazioni descritte. | L’identità resta comprensibile indipendentemente dal formato del file. |
| Distribuzione CSV o JSON | Una rappresentazione specifica del dataset. | Confrontare campi, precisione e copertura prima di supporre equivalenza. |
| Versione identificata | Uno stato preciso e la cronologia delle modifiche. | Ritrovare la versione citata anche se un indirizzo corrente è aggiornato. |
| Correzione o nuovo periodo | Un valore rivisto o un’osservazione diversa. | Non presentare un nuovo mese come correzione automatica del precedente. |
- W3C DCAT 3 : Distribuzioni
Consultato il 22 ottobre 2026; dataset e rappresentazioni, con possibili differenze di fedeltà.
- W3C : Dati sul Web e versioni
Consultato il 22 ottobre 2026; identificatori di versione, cronologia e osservazioni di periodi diversi.
Documenti di riferimento
- W3C - Dati sulle best practice web · Fonte consultata
- IETF : GeoJSON RFC 7946 · Fonte consultata
- data.gouv.fr : Bien documenter un jeu de données
Contenuto aggiornato
Riferimenti documentati per questo argomento
| Riferimento | Valore o sintassi | Ambito |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | I campi con virgole, virgolette o ritorni a capo sono racchiusi tra virgolette; quelle interne raddoppiate. |
| RFC 8259 · JSON | application/json · UTF-8 | JSON standard non ammette commenti né virgole finali; le stringhe usano virgolette doppie. |
Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.
