start

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+*.{cmd,[cC][mM][dD]} text eol=crlf
+*.{bat,[bB][aA][tT]} text eol=crlf

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Domande
+    url: https://github.com/ondata/guidaPraticaPubblicazioneCSV/discussions
+    about: Per favore fai qui le tue domande su questa guida. Se invece devi segnalare un problema o fare una proposta per il codice di questo repo, apri una issue (qui sotto il link "Open a blank issue").

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: ci
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'overrides/**'
+      - 'mkdocs.yml'
+      - '.github/workflows/ci.yml'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: 3.x
+      - run: pip install markupsafe==2.0.1 mkdocs-material markdown mkdocstrings mkdocs-rss-plugin  mkdocs-click
+      - run: mkdocs gh-deploy --force

.gitignore

@@ -0,0 +1,3 @@
+tmp*
+.~lock*
+run_docker.sh

README.md

@@ -0,0 +1,75 @@
+🙏 I [capitoli ancora da creare](https://github.com/ondata/guidaPraticaPubblicazioneCSV/issues?q=is%3Aissue+is%3Aopen+label%3A%22da+elaborare%22+no%3Aassignee+sort%3Acreated-asc), su cui lavorare come indicato [qui](https://github.com/ondata/guidaPraticaPubblicazioneCSV/discussions/52#discussion-3767439).
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-5-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+# 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***.<br>È 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**](https://datos.gob.es/en/documentacion/guia-practica-para-la-publicacion-de-datos-tabulares-en-archivos-csv) (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**](https://github.com/ondata/guidaPraticaPubblicazioneCSV/discussions), 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 <kbd>EDIT</kbd>, 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.
+
+[![](docs/imgs/edit_page.png)](https://ondata.github.io/guidaPraticaPubblicazioneCSV/guida/)
+
+➡ [Leggi la guida](https://ondata.github.io/guidaPraticaPubblicazioneCSV/guida/)
+
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="http://cirospat.readthedocs.io"><img src="https://avatars.githubusercontent.com/u/3757525?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ciro spataro</b></sub></a><br /><a href="#content-cirospat" title="Content">🖋</a> <a href="#example-cirospat" title="Examples">💡</a></td>
+    <td align="center"><a href="http://pigrecoinfinito.com"><img src="https://avatars.githubusercontent.com/u/7631137?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Salvatore Fiandaca</b></sub></a><br /><a href="#content-pigreco" title="Content">🖋</a> <a href="#example-pigreco" title="Examples">💡</a></td>
+    <td align="center"><a href="https://github.com/patrunomeister"><img src="https://avatars.githubusercontent.com/u/482417?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Vincenzo Patruno</b></sub></a><br /><a href="#content-patrunomeister" title="Content">🖋</a> <a href="#example-patrunomeister" title="Examples">💡</a></td>
+    <td align="center"><a href="https://coseerobe.gbvitrano.it/"><img src="https://avatars.githubusercontent.com/u/20488693?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Giovan Battista Vitrano</b></sub></a><br /><a href="#content-gbvitrano" title="Content">🖋</a> <a href="#example-gbvitrano" title="Examples">💡</a></td>
+    <td align="center"><a href="https://github.com/lorenzoperone"><img src="https://avatars.githubusercontent.com/u/5204799?v=4?s=100" width="100px;" alt=""/><br /><sub><b>lorenzo perone</b></sub></a><br /><a href="#content-lorenzoperone" title="Content">🖋</a> <a href="#example-lorenzoperone" title="Examples">💡</a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

docs/index.md

@@ -0,0 +1,24 @@
+---
+title: Guida dei diritti di cittadinanza digitali
+hide:
+ - toc
+ - navigation
+---
+
+# Guida dei diritti di cittadinanza digitali
+
+Il **15 marzo 2022** è [stata pubblicata](https://www.agid.gov.it/it/agenzia/stampa-e-comunicazione/notizie/2022/03/16/online-guida-diritti-cittadinanza-digitali) dall'Agenzia per l'Italia digitale (AgID) la **Guida dei diritti di cittadinanza digitali**.
+
+È un documento previsto dal "[**Codice dell'Amministrazione Digitale**](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2005-03-07;82!vig)", che illustra cos'è la **cittadinanza digitale** e quali sono i diritti digitali di cittadini e imprese.
+
+Come è riportato sul sito di AgID, i diritti di cittadinanza digitali risultano concreti quando chiunque può:
+
+- **accedere** ai **servizi online** in maniera **semplice**, **sicura** e veloce (diritto all’uso delle tecnologie, Identità digitale, accessibilità di siti web e applicazioni mobili);
+- **acquisire rapidamente informazioni affidabili** e/o esprimere chiaramente la propria esigenza, instaurando una **comunicazione rapida** e con **pieno valore giuridico con la pubblica amministrazione** alla quale ci si rivolge per un procedimento o un servizio (istanze telematiche, comunicazioni elettroniche, domicilio digitale);
+- **beneficiare** di **modalità di pagamento digitali** che assicurino maggiore trasparenza e sicurezza (pagamenti con modalità informatiche).
+
+Sono diritti fondamentali, che come associazione chiediamo spesso di fare valere e su cui pensiamo che ancora sia sappia troppo poco. E una cittadinanza che non conosce tutti i propri diretti è più debole, ha meno opportunità.
+
+Il documento è pubblicato ad oggi [**soltanto come PDF**](https://www.agid.gov.it/sites/default/files/repository_files/guida_riepilogo_diritti_cittadinanza_digitale_03-2022-acc.pdf), e questo ne **limita** l'**efficacia** nella **diffusione** e **condivisione**.
+
+Per questo ne abbiamo creato una copia web, suddivisa in sezioni.

docs/parte-prima/a-chi-rivolgersi.md

@@ -0,0 +1,20 @@
+---
+title: A chi rivolgersi per la tutela dei diritti di cittadinanza digitali
+hide: toc
+---
+
+# A chi rivolgersi per la tutela dei diritti di cittadinanza digitali
+
+Per tutelare tali diritti, oltre al Giudice, è possibile rivolgersi anche al Difensore civico per il
+digitale.
+Questa figura svolge la funzione di:
+
+- valutare[^1] le segnalazioni relative a presunte violazioni dei diritti di cittadinanza digitale e,
+    qualora le ritenga non manifestamente infondate le trasmette al Direttore Generale per
+    l’attività di vigilanza, verifica, controllo e monitoraggio dell’AgID[^2];
+- rispetto all’accessibilità, valutare il reclamo nel caso di mancata accessibilità ad un sito
+    internet o ad un’applicazione mobile dell’Amministrazione e, qualora fondato, invitare
+    l’Amministrazione al rispetto delle norme sull’accessibilità.
+
+[^1]: Regolamento recante le procedure finalizzate allo svolgimento dei compiti previsti dall'articolo 17, comma 1-quater, del CAD 4 pubblicato in [GU Serie Generale n.295 del 13-12-2021](http://www.gazzettaufficiale.it/eli/id/2021/12/13/21A07299/sg).
+[^2]: Art. [18 bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2005-03-07;82!vig~art18bis), CAD introdotto dall’art. 41 D.L.77/2021 convertito in L. 108/2021.

docs/parte-prima/cosa.md

@@ -0,0 +1,22 @@
+---
+title: Cosa è
+hide: toc
+---
+
+# Cosa è
+
+Si tratta di diritti digitali che, grazie al supporto di una serie di strumenti e processi (ad esempio
+l’identità digitale, la posta elettronica certificata e il domicilio digitale, le firme elettroniche, i
+pagamenti informatici), contribuiscono a facilitare a cittadini e imprese la fruizione dei servizi della
+Pubblica Amministrazione. Conoscere tali strumenti e le norme che ne regolano l’uso, consente
+inoltre di semplificare il rapporto tra cittadini, imprese e Pubblica Amministrazione.
+Il rapido aumento di dispositivi elettronici come smartphone, tablet, l'utilizzo esteso del computer
+e la diffusione massiccia delle telecomunicazioni sono tutti elementi che influenzano in modo
+sempre più evidente e profondo tutti gli ambiti della società, cambiando il modo di operare non
+solo dei singoli individui, ma anche di intere organizzazioni.
+Da tempo ormai le politiche di sviluppo economico e sociale, nazionali ed europee, sono fondate
+sulla disponibilità di connessione alla rete e sull’utilizzo di Internet e, se guardiamo al settore
+pubblico, sull’integrazione di soluzioni digitali nell’ambito della pubblica amministrazione e sulla
+digitalizzazione per offrire servizi in rete.
+Conoscere i diritti, gli strumenti e le soluzioni tecnologiche di cui si può disporre per rapportarsi,
+con la Pubblica Amministrazione, è fondamentale per esercitare appieno i diritti di cittadinanza.

docs/parte-prima/quali-diritti.md

@@ -0,0 +1,50 @@
+---
+title: Quali diritti
+hide: toc
+---
+
+# Quali diritti
+
+I diritti di cittadinanza digitali risultano concreti quando chiunque può:
+
+- accedere ai servizi online in maniera semplice, sicura e veloce (diritto all’uso delle
+    tecnologie, Identità digitale, accessibilità di siti web e applicazioni mobili);
+- acquisire rapidamente informazioni affidabili e/o esprimere chiaramente la propria esigenza,
+    instaurando una comunicazione rapida e con pieno valore giuridico con la pubblica
+    amministrazione alla quale ci si rivolge per un procedimento o un servizio (istanze
+    telematiche, comunicazioni elettroniche, domicilio digitale);
+- beneficiare di modalità di pagamento digitali che assicurino maggiore trasparenza e
+    sicurezza (pagamenti con modalità informatiche).
+
+## Diritto all’uso delle tecnologie
+
+Chiunque ha il diritto di usare in modo accessibile ed efficace le tecnologie nei rapporti e nelle
+comunicazioni con le pubbliche amministrazioni, con i gestori di pubblici servizi e le società a
+controllo pubblico, ad esempio come l’invio e l’accesso ai documenti informatici o ai servizi
+tramite l’identità digitale (SPID, CIE, CNS) o il poter effettuare i pagamenti online verso le
+amministrazioni.
+
+## Diritto all’accessibilità
+
+È il diritto delle persone, in particolare quelle con disabilità, di accedere a tutte le fonti di
+informazione e ai relativi servizi in rete e di pubblica utilità nel settore privato e pubblico
+attraverso le tecnologie assistive o configurazioni particolari (ad es. accedere a documenti
+pubblicati in formato accessibile, usare siti e applicazioni mobili organizzati in una struttura
+informativa di facile consultazione, ecc.).
+
+## Diritto all’identità digitale
+
+Chiunque ha il diritto di accedere ai servizi online offerti dalle pubbliche amministrazioni, da
+gestori di servizi pubblici e da società a controllo pubblico tramite la propria identità digitale (SPID,
+CIE, CNS), in maniera semplice e sicura, in qualsiasi momento e da qualsiasi dispositivo.
+
+
+## Diritto ad effettuare pagamenti con modalità informatiche
+
+Chiunque ha il diritto di effettuare tutti i pagamenti verso la Pubblica Amministrazione, i gestori di
+servizi pubblici e le società a controllo pubblico attraverso sistemi di pagamento elettronico.
+
+## Diritto a comunicare con i soggetti del settore pubblico utilizzando esclusivamente modalità e strumenti informatici
+
+È il diritto di comunicare con la Pubblica Amministrazione e gli altri soggetti che gestiscono un
+servizio pubblico utilizzando modalità e strumenti informatici.

docs/parte-prima/vantaggi.md

@@ -0,0 +1,26 @@
+---
+title: Cosa è
+hide: toc
+---
+
+# I vantaggi
+
+Le pubbliche amministrazioni hanno avviato, attraverso l’adozione delle tecnologie informatiche,
+un percorso che richiede una profonda riorganizzazione interna delle proprie attività e delle
+modalità con le quali erogare i servizi a cittadini e imprese. Questa profonda trasformazione
+digitale ha lo scopo principale di semplificare il rapporto cittadino-pubblica amministrazione.
+Per raggiungere tale obiettivo l’Italia si è dotata anche di una [strategia globale per le competenze digitali](https://innovazione.gov.it/strategia-nazionale-per-le-competenze-digitali/), base essenziale per l’attuazione di interventi organici, multisettoriali ed efficaci su un’area
+fondamentale per lo sviluppo economico e sociale del Paese. Difatti le competenze digitali
+rappresentano una priorità strategica.
+Il principale strumento tramite il quale la Pubblica Amministrazione procede in questo percorso di
+digitalizzazione è il Codice dell’Amministrazione Digitale – CAD (Decreto Legislativo 7 marzo 2005,
+n. 82) che, fra l’altro, contiene anche i diritti di cittadinanza digitale (Capo I, Sezione II, artt. 3-9).
+Essere cittadini digitali significa avere:
+
+- un accesso semplice e sicuro ai servizi della Pubblica Amministrazione;
+- un’interazione “diretta” con i diversi enti della Pubblica Amministrazione;
+- la possibilità di esercitare la cittadinanza attiva, ovvero partecipare alle politiche pubbliche e
+    al dialogo democratico con la Pubblica Amministrazione;
+- la consapevolezza nell’uso degli strumenti informatici disponibili e dei benefici che derivano
+    da un loro [uso consapevole](https://www.agid.gov.it/sites/default/files/repository_files/competenze_digitali_per_i_cittadini.pdf);
+- le informazioni sui propri diritti e su come questi possono essere garantiti e tutelati.

docs/parte-seconda/index.md

@@ -0,0 +1,17 @@
+---
+title: I diritti e la tutela
+hide: toc
+---
+
+# I diritti e la tutela
+
+La seconda parte della Guida approfondisce i diritti di cittadinanza digitale, richiamando anche:
+
+- riferimenti normativi ed eventuali provvedimenti attuativi;
+- strumenti specifici di tutela;
+- link di approfondimento.
+
+L'intento è di soffermarsi non tanto su norme o su tecnicismi, ma, piuttosto, sulle modalità per
+l'esercizio dei diritti di cittadinanza digitali previsti dal Codice dell'Amministrazione Digitale (CAD, vedi [appendice](../appendice.md)).
+Viene infine descritta la possibilità di tutela degli utenti nei confronti delle Pubbliche
+Amministrazioni tramite segnalazioni e reclami che possono essere inviati al [Difensore civico per il digitale](https://www.agid.gov.it/it/agenzia/difensore-civico-il-digitale).

docs/parte-seconda/uso-delle-tecnologie.md

@@ -0,0 +1,34 @@
+---
+title: Uso delle tecnologie
+hide: toc
+---
+
+# Uso delle tecnologie[^1]
+
+## In cosa consiste
+
+È il diritto di chiunque di usare in modo accessibile ed efficace le tecnologie nei rapporti con le
+pubbliche amministrazioni, con i gestori di pubblici servizi e le società a controllo pubblico, ad
+esempio, accedendo ai servizi tramite l’identità digitale o effettuando i pagamenti nei confronti
+delle pubbliche amministrazioni in modalità telematica. Anche i privati[^2] devono garantire il diritto
+all’uso delle tecnologie relativamente al documento informatico, alle firme elettroniche[^3] , ai servizi
+fiduciari per le transazioni elettroniche nel mercato interno, alla riproduzione e conservazione dei
+documenti, al domicilio digitale, alle comunicazioni elettroniche, all’identità digitale.
+
+## Come può essere tutelato questo diritto
+
+Tramite le ordinarie modalità di tutela amministrativa e giudiziaria. Seppure non sostitutiva delle
+precedenti modalità di tutela è possibile anche inviare una segnalazione al Difensore civico per il digitale per problematiche attinenti al diritto all’uso delle tecnologie ( vedi paragrafo 11 tutela dei
+diritti: il Difensore civico per il digitale).
+
+## Casi pratici
+
+- Invito 8/2020 <https://www.agid.gov.it/sites/default/files/repository_files/adg-2020-0006026-allegato-segn_122-2019_inviton8-2020_maeci.pdf>
+- Invito 26/2020 <https://www.agid.gov.it/sites/default/files/repository_files/adg-2020-0014892-allegato-segnalazione_80_2020_invito26-2020.pdf>
+- Invito 28/2020 <https://www.agid.gov.it/sites/default/files/repository_files/adg-2020-0014897-allegato-segnalazione_107_2020_invito28-2020.pdf>
+
+
+
+[^1]: art. 3 CAD <http://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2005-03-07;82!vig=2021-05-27~art3>
+[^2]: art. 2. comma 3, CAD <http://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2005-03-07;82!vig=2021-05-27~art2>
+[^3]: Sull’argomento si rinvia al documento reperibile a [questo indirizzo](https://www.agid.gov.it/sites/default/files/repository_files/tipologie_di_firme_e_sigilli_elettronici_v1_dicembre_2019.pdf). Inoltre con la Carta d’Identità Elettronica (CIE) e dispositivi dotati di interfaccia NFC come si può firmare con firma elettronica avanzata (FEA) attraverso l’app sviluppata dal Poligrafico e Zecca dello Stato Italiano CieSign.