Modello di contribuzione

Le indicazioni operative per contribuire all'evoluzione della documentazione e delle risorse del design system del Paese

Come contribuire
In breve

Prendi parte all’evoluzione del design system dedicato 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 del design system del Paese è 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?

Il design system del Paese è per tutte le persone, e ogni persona della community può offrire un contributo basato su dati, ricerca utente e test sul campo.

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.

I contributor come te sono ciò che rende questo design system vivo, e per questo ti siamo grati.

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 al design system ci piace ringraziarla pubblicamente, ma se preferisci non ricevere menzioni pubbliche, puoi farcelo sapere durante la contribuzione.

Scopri il piano delle attività e lo stato dei lavori

Per esplorare lo stato dell’arte della documentazione e delle risorse puoi fare riferimento al piano che contiene la roadmap delle attività e i principali risultati raggiunti dal progetto Designers Italia negli ultimi mesi e anni. Per capire le attività in lavorazione in questo momento fai riferimento alla board di progetto.

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.

Approfondisci le modalità nelle schede dedicate

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