Come contribuire ai modelli

Le indicazioni operative per contribuire all'evoluzione dei modelli di siti e servizi della pubblica amministrazione

Come contribuire
In breve

Prendi parte all’evoluzione dei modelli di siti e servizi dedicati alla PA italiana: contribuisci alle discussioni, agli avanzamenti tecnici e di design e scopri come proporre novità e nuove idee da condividere con il team e la community di Designers Italia.

Metadati e link per approfondire

L'evoluzione dei modelli di siti per la pubblica amministrazione è aperta

Scopri come contribuire in base alle tue competenze e al tempo che hai a disposizione.

La documentazione e le risorse principali di design e sviluppo sono manutenute del team di Designers Italia con un approccio aperto e trasparente, privilegiando strumenti che permettono di seguire i lavori in tempo reale e di prendere parte alle evolutive tecniche e alle novità di progettazione.

Perché contribuire?

Crediamo infatti che siti e servizi digitali progettati in modo collaborativo siano migliori e quindi che il contributo attivo della community che osserva, utilizza, personalizza e implementa quotidianamente le soluzioni proposte sia fondamentale per far crescere la qualità della documentazione e delle risorse operative a supporto delle PA.

Cosa puoi fare?

Partecipare a discussioni, aprire segnalazioni e inviare contributi.

Dalla segnalazione di una correzione alla proposta di un’integrazione, dalla presentazione di un nuovo componente alla partecipazione a discussioni su modifiche futuribili, come contributor puoi prendere parte al miglioramento continuo del progetto e alla realizzazione di siti e servizi digitali della PA sempre migliori.

Ti suggeriamo di pensare oltre il singolo servizio digitale per immaginare componenti ed esperienze scalabili, riusabili e che possono evolvere nel tempo. Condividi ciò che hai imparato nel fare ricerca con gli utenti. Sii disponibile a ricevere feedback o richieste di modifica al tuo lavoro. Sii gentile e incoraggia gli altri a esserlo, quando ricevi domande o feedback.

Quando una persona della community contribuisce ci piace ringraziarla pubblicamente, ma se preferisci non ricevere menzioni pubbliche, puoi farcelo sapere durante la contribuzione.

Usa il tuo profilo personale, o creane uno nuovo

Per contribuire hai bisogno di un profilo personale gratuito sulla piattaforma GitHub.

Se hai bisogno di un nuovo profilo:

  1. Naviga su github.com e segui le istruzioni
  2. Verifica il tuo indirizzo email e abilita l'autenticazione a due fattori (2FA)
  3. Imposta un'immagine del profilo come gesto di cordialità verso la community

Scegli come e dove contribuire

Puoi collaborare ai lavori sulla presente documentazione, ai lavori sulle risorse di design e su quelle di sviluppo.

Puoi farlo:

  1. Partecipando alle discussioni aperte nei repository delle risorse
  2. Aprendo nuove segnalazioni sul tema di tuo interesse laddove non sia già presente
  3. Inviando contributi e integrazioni

Qui puoi trovare il Codice di condotta della community legata ai progetti dell'organizzazione Italia su GitHub, strumento utile a mantenere un ambiente di collaborazione inclusivo e propositivo per tutte le persone.

Esplora le risorse a cui puoi contribuire

Nota sulla lingua
  1. Puoi trovare frequentemente discussioni in lingua inglese perché considerata lingua franca dei progetti open source, in particolare per i temi di design e sviluppo
  2. Laddove le discussioni siano inerenti alla documentazione e ai contenuti, ci sembra però ragionevole usare la lingua italiana per le contribuzioni
  3. Sono ovviamente benvenuti in maniera paritetica contributi in italiano e in inglese
Note sullo sviluppo
  1. Tutti gli esempi presenti nella documentazione fanno riferimento al framework di sviluppo Bootstrap Italia
  2. La risorsa utile a standardizzare stili e scelte di progettazione Design Tokens Italia è per ora collegata solo a UI Kit Italia lato design, sono in corso le lavorazioni per l'integrazione in Bootstrap Italia lato sviluppo, sono benvenuti contributi in merito
  3. I framework di sviluppo React e Angular Kit allo stato dell'arte sono manutenuti dalla community