Docs Italia beta

Documenti pubblici, digitali.

6.6. I documenti

La dematerializzazione dei documenti, ovvero l’uso di documenti elettronici al posto di quelli cartacei, è un punto cardine della trasformazione digitale della Pubblica Amministrazione. I documenti elettronici sono destinati a diventare il principale mezzo per veicolare informazioni, sia all’interno della PA che verso i cittadini.

I contenuti - e quindi anche i documenti - sono una delle componenti che concorrono a definire la qualità dell’esperienza di fruizione dei servizi digitali da parte del cittadino. Per questo motivo devono essere prodotti secondo criteri di semplicità, devono essere facili da trovare e da leggere e usare un linguaggio comprensibile per il cittadino. La qualità e la semplicità dei contenuti deve essere periodicamente verificata con attività di ricerca utente come A/B test e test di usabilità da parte degli utenti - cittadini, imprese e dipendenti della Pubblica Amministrazione.

6.6.1. I documenti vanno sul web

Principi come la trasparenza e l’open government fanno sì che qualsiasi testo, documento o legge della Pubblica Amministrazione sia considerato pubblico e di potenziale interesse per i cittadini.

Per questo motivo quasi tutti i contenuti della Pubblica Amministrazione già oggi vengono pubblicati sul web. Questo, però, non basta per informare i cittadini, per realizzare il concetto di trasparenza o per mettere in pratica una filosofia di open government: i contenuti ci sono ma sono troppo complessi, disorganizzati e difficili da trovare. Gran parte dei contenuti e dei documenti vengono scritti come se fossero a uso interno, senza impegno verso la semplificazione, l’accessibilità, l’inclusione.

La Pubblica Amministrazione deve iniziare a scrivere in modo semplice tutti i tipi di contenuto (compresi atti, norme, circolari), utilizzando come buone pratiche le regole di scrittura tipiche del web: questo, infatti, è il luogo dove i documenti verranno letti.

I contenuti di un buon documento dovrebbero essere:

  • utili;

  • comprensibili;

  • ben organizzati;

  • leggibili;

  • accessibili.

Per approfondire: Guida al linguaggio della Pubblica Amministrazione

6.6.2. Tipi di documenti

Le pubbliche amministrazioni scrivono quotidianamente vari tipi di documenti, con scopi e destinatari diversi. La struttura e il modo in cui vengono presentate le informazioni determinano l’efficacia o meno del contenuto.

Per alcuni tipi di documento, è possibile individuare degli schemi fissi che è possibile sfruttare per creare nuovi testi. Ecco alcuni modelli che sono spesso usati dalla Pubblica Amministrazione:

Tipo di documento

Scopo

Caratteristiche

Documenti di progetto

Descrive il piano di sviluppo di un progetto. Serve a pianificare operazioni e risorse e a stabilire gli obiettivi.

  • descrizione del progetto

  • benefici

  • roadmap di sviluppo

  • risorse necessarie

Documenti tecnici e specifiche

Descrive le caratteristiche tecniche di un prodotto o servizio per un pubblico di tecnici.

  • molti dettagli tecnici

  • linguaggio semplice

Documenti amministrativi

Offre alcuni consigli su come strutturare i contenuti di linee guida, circolari e altri documenti amministrativi.

  • generalità degli argomenti

  • attenzione a titolo, sommario e riferimenti normativi

Email e newsletter per i cittadini

Aggiorna e coinvolge gli utenti sulle novità e le iniziative che si vogliono comunicare.

  • scopo ben preciso di ogni invio

  • contenuto chiaro e sintetico

Usa i suggerimenti e la struttura dei contenuti presenti in questi modelli per semplificare la scrittura di nuovi documenti.

6.6.3. Formato di lettura dei documenti elettronici

Prima di pubblicare un documento, le amministrazioni dovrebbero fare una riflessione sulla funzione che svolge e sulle esigenze degli utenti:

  • Il documento verrà letto direttamente online?

  • Deve poter essere scaricato?

  • Deve poter essere modificato dagli utenti oppure no?

Partendo dall’idea che i documenti della Pubblica Amministrazione verranno letti online e, sempre più spesso, anche attraverso dispositivi mobili, il modo più naturale per rappresentarli è la forma di una pagina web. L’uso del formato Html presenta diversi vantaggi per l’utente, tra cui la possibilità di avere una pagina responsive (quindi leggibile anche sugli smartphone), consentire una buona indicizzazione del contenuto e dare la possibilità di condividere un punto specifico del documento tramite link interni.

Siccome le persone possono avere la necessità di salvare sul proprio dispositivo il contenuto e poi eventualmente stamparlo, è opportuno creare la funzione “Salva/stampa come Pdf” che consentirà di salvare documenti o form costruiti online.

L’idea di base è che tutta l’esperienza dell’utente avviene sul web, e la conversione in Pdf viene utilizzata solamente per una funzione specifica, che è quella di conservare sul proprio dispositivo il documento e stamparlo, se necessario.

In poche occasioni, l’amministrazione potrebbe avere la necessità di mettere a disposizione dell’utente dei documenti in formato aperto. In questo caso, per i formati di tipo documentale suggeriamo di condividere i documenti in formato Odt, mentre per i fogli di calcolo suggeriamo di utilizzare il formato Ods.

Quando per qualche motivo non è possibile mostrare il contenuto del documento in Html ma solo in formato Pdf (o in un altro formato di tipo documentale, come un Odt), è bene in ogni caso creare una pagina web che riporti almeno il titolo e la descrizione del documento Pdf che si intende pubblicare per favorire l’indicizzazione dei contenuti sul web.

Importante

La soluzione più adatta è mostrare il contenuto in formato Html. Se ciò non è possibile, si possono usare altri formati, ma si deve sempre creare una pagina web corrispondente al documento che riporti titolo e descrizione del contenuto.

approfondimento

Maggiori informazioni sui principali formati documentali.

6.6.4. Modalità di produzione dei documenti

Le pubbliche amministrazioni hanno l’obbligo di conservare i documenti elettronici che producono o che ricevono, attraverso risorse interne o avvalendosi di soggetti esterni accreditati. Il processo di conservazione serve a garantire “autenticità, integrità, affidabilità, leggibilità, reperibilità” del documento stesso. Ma l’obiettivo principale di un documento è e resta quello di rispondere in modo semplice ai bisogni degli utenti per i quali è stato scritto, rispondendo a criteri di efficacia e inclusione. Dato che tutti i documenti della PA vengono pubblicati sul web, anche la modalità di creazione dei contenuti deve tener conto di questo fatto. Come abbiamo visto in precedenza, esistono essenzialmente due strade.

Creazione di un contenuto in formato Html in modo nativo

Con questo approccio, è possibile per esempio:

  • creare un form online per raccogliere i dati altrimenti richiesti attraverso un documento Odt;

  • creare una circolare online e poi dare all’utente la possibilità di convertirla in Pdf.

Questa strada è quella consigliata a tutti i livelli. Di seguito trovi l’approccio seguito dal progetto Docs Italia che, in modo coerente rispetto a questa impostazione, rappresenta una piattaforma a disposizione di tutte le amministrazioni per creare documenti e gestire i processi di consultazione come previsto dal CAD, art. 18.

approfondimento

La piattaforma di Docs Italia è a disposizione per le pubbliche amministrazioni che intendono pubblicare documenti tecnici e amministrativi sul web, in un formato Html responsive adatto per essere visualizzato su qualsiasi dispositivo.

Il documento viene presentato in maniera nativa come pagina Html, ma in ogni momento è possibile scaricare una versione Pdf o ePub. Il contenuto, infatti, viene scritto su file di testo che vengono compilati e trasformati in pagina web, proprio come avviene con molti sistemi di gestione dei contenuti.

Docs Italia è un progetto che si basa sull’approccio alla creazione della documentazione chiamato docs as code, ovvero “documenti come codice”.

Per approfondire: L’approccio docs as code di Gov.uk (in inglese)

Tutto il codice sorgente dei documenti di Docs Italia è ospitato su repository pubblici di GitHub, ai quali chiunque può contribuire con suggerimenti e modifiche. L’uso di un sistema di controllo delle versioni consente, inoltre, di memorizzare tutte le precedenti versioni di un documento e di ripristinarle in qualsiasi momento, se necessario.

Per approfondire: Breve descrizione di Docs Italia e Guida alla pubblicazione.

Pubblicare sul web documenti di vario formato (Pdf, Odt e Ods)

In questo caso, è necessario accompagnare sempre i documenti con una pagina web che li descriva, con un titolo e una descrizione breve, in modo da favorire la fruibilità e l’indicizzazione del contenuto.

Di seguito trovi un approfondimento sulle buone pratiche per la gestione dei Pdf.

approfondimento

Oltre che essere accompagnati da una pagina Html di descrizione, i file dei documenti di testo allegati dovrebbero essere creati rispettando alcune buone pratiche.

Rendi il documento accessibile

  • Il documento Pdf deve essere creato digitalmente, non deve essere una scansione di un documento cartaceo.

  • Quando scrivi il documento in un editor di testo, usa le opzioni di titolo, sottotitolo e corpo del testo per creare una gerarchia delle informazioni.

  • Inserisci all’inizio del documento un indice navigabile per permettere a chi legge di raggiungere facilmente le varie sezioni.

  • Usa le opzioni di elenco puntato e numerato, invece di indicare gli elenchi con un trattino o un numero.

  • Accompagna ogni immagine con un testo alternativo (alt text).

  • Verifica l’accessibilità del documento Pdf prima di pubblicarlo.

  • Mantieni ridotte le dimensioni del file, dividendo, se necessario, i file troppo grossi in capitoli.

Inserisci i metadati

I metadati sono informazioni aggiuntive che vengono associate al documento automaticamente in fase di creazione, oppure manualmente.Aggiungi dei metadati al documento Pdf per aiutare gli utenti a trovare più facilmente il documento.

I principali metadati che possono essere associati a un documento sono:

  • titolo;

  • autore;

  • descrizione;

  • parole chiave.

Naturalmente, più sono specifiche e dettagliate le informazioni che fornisci, più il documento risulterà rilevante nelle ricerche degli utenti.

Questo sito utilizza cookie tecnici, analytics e di terze parti. Proseguendo nella navigazione accetti l’utilizzo dei cookie.
Cookie policy