Developers Italia Il Piano Triennale: verso il sistema operativo del paese 05/07/2017 Giovanni Bajo – Developer Relation [email protected]
Jan 24, 2018
Developers Italia Il Piano Triennale: verso il sistema operativo del paese 05/07/2017 Giovanni Bajo – Developer Relation [email protected]
Problema Perché usare le tecnologie progettate
dallo Stato dev’essere così difficile?
Facebook vs SPID
Facebook login
• Sito dedicato ben identificabile • Tantissima documentazione • SDK per tutti i principali linguaggio • Esempi di ogni tipo • Issue tracker e forum
Login con SPID (2016)
Login con SPID (2016)
Login con SPID (2016)
Login con SPID (2016)
• Sito tecnico non esistente • PDF pubblicati nell’area documenti di AgID • Regole tecniche in PDF • Approccio giuridico/normativo alla
tecnologia
Tempo di integrazione in MVP
• Facebook Login: ~2h • SPID: ~10gg
Riassumiamo: • Documentazione superficiale e spesso non dettagliata
• Nessun SDK • Nessun esempio • Nessun ambiente di testing • Nessun canale di comunicazione per
tecnici • Mancanza totale di gestione del
versioning
Developers Italia
Developers Italia
• Piattaforma di sviluppo per le tecnologie abilitanti del Piano Triennale
• Basata su strumenti leader di mercato: GitHub, ReadTheDocs, Discourse
• Approccio collaborativo
Chi è al lavoro?
• TUTTI! • Personale direttamente assegnato ai
progetti: dipendenti o consulenti • Coinvolgimento delle in-house • Coinvolgimento di PAC / PAL • Volontari
Progetti
Login con SPID (2017) • Roadmap pubblica di sviluppo • Maintainer chiaramente identificati • Call quindicinale di aggiornamento • Ambiente di staging (IdP test) in arrivo • Esempi di SP già pronti su varie tecnologie • SDK in preparazione per vari framework
Github (github.com/italia)
• Vediamolo live…
Approccio collaborativo
• Si lavora insieme su documentazione e software
• Si usano Pull Request e Issue • Non c’è “giusto o sbagliato”: ogni cosa si
può migliorare insieme
ReadTheDocs
• Scrittura ASCII-based: RestructuredText • Link permanenti per ogni capitolo • Ricerca a tutto testo • Versioni multiple per iterazioni successivi • Possibilità di integrare plugin
ReadTheDocs
• Vediamolo live…
ReadTheDocs
• Vediamo come modificare del testo in RestructuredText
Discourse (forum.italia.it)
• Diversi topic di discussione • Comunicazione 1:N, piena indicizzazione • Possibilità di chiedere chiarimenti • Approccio informale
Discourse (forum.italia.it)
• Vediamolo live…
Non solo Developers…
• Vogliamo portare l’approccio anche ad altre aree dello sviluppo digitale del paese
Designers Italia
Piano Triennale
In futuro…
• Linee guida, regole tecniche in formato RTD
• Approccio community sui draft • Partnership pubblico-privato per restauro
servizi digitali
In arrivo… hackathon!
In arrivo… hackathon!
• Grande hackathon distribuito sul territorio • 20 sedi • Obiettivo: chiamare a raccolta più di 1000
sviluppatori • 6-7-8 Ottobre
Cosa potete fare voi?
• Iscrivetevi a newsletter e forum • Utilizzatelo come canale primario per
richiedere chiarimenti • Segnalateci (o risolvete!) ogni errore che
vedete • Contribuite!
teamdigitale.governo.it [email protected] @team-per-la-trasformazione-digitale @company/teamdigitale