come contribuire al processo di cambiamento. la comunità di developers.italia.it - giovanni bajo,...

Developers Italia Il Piano Triennale: verso il sistema operativo del paese 05/07/2017 Giovanni Bajo – Developer Relation giovanni@teamdigitale.governo.it

Problema Perché usare le tecnologie progettate

dallo Stato dev’essere così difficile?

Facebook vs SPID

Facebook

Facebook

Facebook

Facebook

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 giovanni@teamdigitale.governo.it @team-per-la-trasformazione-digitale @company/teamdigitale