1. Scopo, destinatari e uso del Manuale operativo di design¶
Questo manuale è uno degli strumenti di Designers Italia per supportare gli enti pubblici a raggiungere gli obiettivi definiti dalle Linee guida di design per i siti internet e i servizi digitali della PA. Il manuale vuole essere un punto di riferimento per la Pubblica Amministrazione e i suoi fornitori, descrive un metodo di lavoro condiviso e fornisce una serie di risorse metodologiche, strumenti pratici ed esempi a supporto della progettazione e realizzazione di siti e servizi digitali della Pubblica Amministrazione.
I destinatari di questo manuale sono principalmente:
i decisori politici, affinché siano abilitatori consapevoli e cooperino al miglioramento e all’innovazione del Paese a partire da conoscenze pratiche sul tema del design dei servizi digitali;
il personale amministrativo della Pubblica Amministrazione, affinché possano adempiere ai loro doveri di avviatori e gestori di processi di transizione digitale avendo più chiara la materia oggetto di tali processi;
il personale tecnico degli enti pubblici, delle società in-house e dei fornitori di servizi, applicativi e infrastrutture digitali delle pubbliche amministrazioni, affinché siano sempre più aggiornati su processi tecnici di progettazione e le relative buone pratiche.
Questo manuale operativo si propone di supportare:
la modellazione di servizi digitali sulla base di esigenze concrete e risorse esistenti evitando sprechi, duplicazione di attività e creando touchpoint (punti di contatto digitali) e servizi utili;
la progettazione e lo sviluppo di flussi di interazione chiari, che possano rispondere con efficacia alle necessità dei diversi utenti, generando un’esperienza d’uso positiva;
la corretta allocazione delle risorse, basata sull’identificazione delle priorità e l’adozione di standard che evitino sprechi e duplicazioni di attività;
la pratica amministrativa di amministratori e i tecnici della PA negli adempimenti normativi descritti dalle Linee guida.
1.1. Versionamento e storico¶
Il Manuale operativo di design beneficia del version control system (sistema di controllo versione) di GitHub, per cui esiste una traccia pubblica di tutte le modifiche effettuate e dei relativi autori. Il Manuale operativo adotta un sistema di release (rilascio) basato sui tag di GitHub. Ogni release è etichettata secondo un sistema basato su anno e versione. Le versioni sono espresse attraverso un numero progressivo. Il sistema delle release è in vigore dal 2022, quindi la prima release delle linee guida è 2022.1 (prima release del 2022).
Il manuale contiene le indicazioni operative a supporto delle Linee guida di design dei siti internet e servizi digitali della PA, emanate a norma CAD e disponibili in un documento sulla pagina Docs Italia creato ad hoc. Di interesse che sia le Linee guida a norma CAD, che il presente manuale, sono la diretta evoluzione delle precedenti Linee guida di design per i siti web della PA, ancora disponibili a solo scopo di consultazione storica sulla relativa pagina di Docs Italia.
I nuovi contenuti e le modifiche a contenuti esistenti - dopo essere approvati - vengono pubblicati nella versione “bozza” del manuale operativo, disponibile per una discussione pubblica e revisione da parte della community. Solo successivamente, in occasione di una nuova release del manuale, il team di Designers Italia valuta eventualmente di consolidare e farle confluire, dopo eventuali modifiche, nella versione ufficiale “stabile”.
1.2. Stile della documentazione¶
Il Manuale operativo di design è stato redatto seguendo la style-guide (guida di stile) di redazione dei testi pubblici. In particolare:
linguaggio semplice e comprensibile a un pubblico ampio;
brevità e uso di elenchi;
ricorso ad esempi, meglio se supportati da immagini e collegamenti.
1.3. Consultazione della documentazione¶
La documentazione è disponibile su Docs Italia, la piattaforma di gestione della documentazione pubblica gestita dal Dipartimento per la trasformazione digitale. Tutti i documenti di Docs Italia possono essere fruiti anche in formato .epub e .pdf.
1.4. Sviluppo collaborativo¶
Il presente manuale è un documento pubblico, e chiunque può partecipare al processo di revisione e aggiornamento attraverso gli strumenti messi a disposizione attraverso GitHub, in particolare le issues (per le discussioni) e le pull request (per le proposte di modifica).
I contenuti del manuale sono redatti in file .rst e possono essere aggiornati via GitHub. Qui è disponibile una guida alla sintassi RST.
Altre risorse per l’editing in formato .rst:
Il Manuale operativo di design si colloca all’interno di un sistema in continua evoluzione e si basa su una logica di miglioramento continuo. Poiché i contenuti presenti all’interno del manuale operativo di design evolvono continuamente, diventa fondamentale introdurre il versionamento che consente di tenere traccia dei diversi rilasci nel tempo. Grazie al versionamento, chi realizza siti e servizi aderenti alle Linee guida a norma CAD di riferimento, può citare una precisa versione del manuale operativo di design che utilizza (da citare, ad esempio, quando si partecipa a un bando di gara).