Docs Italia è un servizio a disposizione delle Pubbliche Amministrazioni per pubblicare documenti tecnici e amministrativi, e offre ai cittadini la possibilità di leggere e commentare documenti pubblici.
Questo repository ospita la piattaforma di pubblicazione ed è un fork del progetto open-source ReadTheDocs, di cui modifica a fondo le modalità di pubblicazione e l'esperienza utente.
Se sei interessato alla pubblicazione su Docs Italia, ti rimandiamo alla Guida alla Pubblicazione; se invece vuoi contribuire al progetto, dai un'occhiata alle indicazioni su come contribuire a Docs Italia e inizia installando la piattaforma con gli scripts di deploy. Alcune delle tematiche principali sono state identificate e descritte nelle Wiki di progetto.
Il progetto Docs Italia si compone inoltre di altre componenti e guide che lo rendono un servizio completo a disposizione delle Pubbliche Amministrazioni:
- Gli scripts di deploy della piattaforma: https://github.com/italia/docs-italia-deploy-scripts
- Il tema Sphinx per i documenti: https://github.com/italia/docs-italia-theme (il nuovo tema è attualmente sul branch
bootstrap-italia
) - Un convertitore per documenti nei formati più diffusi: https://github.com/italia/docs-italia-comandi-conversione
- Un'applicazione Django basata sul convertitore sopra indicato: https://github.com/italia/docs-italia-convertitore-web
- La guida per la pubblicazione su Docs Italia: https://github.com/italia/docs-italia-guide (pubblicata qui)
- Uno "starter kit" per la pubblicazione: https://github.com/italia/docs-italia-starter-kit
Vuoi segnalare un bug?
Puoi aprire una issue descrivendo ciò che non funziona: trovi maggiori informazioni qui.