Pubblica dati aperti comprensibili e documentati

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.

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 — Documentare attentamente un set di dati.