Guida pratica per la pubblicazione di dati tabellari in formato CSV

Questo progetto nasce per creare una guida per la pubblicazione sul web di dati in formato CSV (Comma Separated Values). È un formato di testo strutturato, che può avere una riga di intestazione, in cui i valori di ogni colonna sono distinti con un separatore che di solito è la ,.

Ad esempio:

nome_comune,abitanti,cod_istat
Palermo,636783,082053
None,8028,001168
Cella Dati,506,019028

È uno dei formati più diffusi per la pubblicazione di dati testuali, sicuramente il più diffuso nei portali open data.
È principalmente utilizzato per intermediare l'accesso ai dati, per non avere barriere tecnologiche, ma non come formato di "lavoro": non è possibile definire il tipo di campo (se un campo è numerico o testuale), se è obbligatorio esprimere un valore per i dati di una colonna, non dispone di indici, ecc..

💡 Vista la loro diffusione abbiamo creato una guida per la "buona" pubblicazione di questi file.

Questa guida è ispirata fortissimamente (ne è in parte la traduzione) dalla splendida guida del "Ministry of Economic Affairs and Digital Transformation” di Spagna (a loro un grazie!), ma non ne è una perfetta copia, ci sono nuove sezioni e alcuni contenuti sono stati modificati o aggiornati.

Partecipa

Questa guida è un bene comune, sia per il lettore che per l'autore.

Da lettore, sei libero di:

Condividere — riprodurre, distribuire, comunicare al pubblico, esporre in pubblico, rappresentare, eseguire e recitare questo materiale con qualsiasi mezzo e formato
Modificare — remixare, trasformare il materiale e basarti su di esso per le tue opere per qualsiasi fine, anche commerciale.

Alle seguenti condizioni:

Attribuzione — Devi riconoscere una menzione di paternità adeguata, fornire un link alla licenza e indicare se sono state effettuate delle modifiche. Puoi fare ciò in qualsiasi maniera ragionevole possibile, ma non con modalità tali da suggerire che il licenziante avalli te o il tuo utilizzo del materiale.
Divieto di restrizioni aggiuntive — Non puoi applicare termini legali o misure tecnologiche che impongano ad altri soggetti dei vincoli giuridici su quanto la licenza consente loro di fare.

Da autore puoi:

se non sai usare git e GitHub: aprire una nuova discussione qui, con delle proposte, suggerimenti, domande o per mostrarci per cosa ti è stata utile questa guida;
se sai usare git e GitHub:
- clonare il repository e fare delle Pull Request;
- proporre delle modifiche al testo e suggerire delle correzioni, utilizzando il tasto EDIT, che trovi in ogni pagina, in alto a destra (vedi immagine sotto) e fare sempre delle Pull Request, ma più "visuali", direttamente dall'interfaccia web.