Come contribuire ai modelli

Le risorse dei modelli sono ospitate sulla piattaforma gratuita GitHub. Lì puoi partecipare a discussioni già aperte, aprire nuove segnalazioni o inviare i tuoi contributi. Ti suggeriamo di condividere ciò che hai imparato facendo ricerca con gli utenti e di proporre componenti ed esperienze scalabili, riusabili e che possono evolvere nel tempo.

Accedi su GitHub con il tuo profilo personale, o creane uno nuovo

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

Consulta 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.

Controlla se già esiste una segnalazione sul tema che ti interessa

Esplora la lista di tutte le discussioni (issues) nel repository della risorsa a cui hai scelto di contribuire. Se già esiste una segnalazione sul tema che ti interessa, o su un tema simile, vai nella discussione dedicata e partecipa lasciando un commento.

Apri una nuova segnalazione o invia i tuoi contributi

Se il tema di tuo interesse non è già presente nella lista delle segnalazioni, puoi aprirne una nuova. Se accettate, le tue modifiche verranno direttamente integrate in un aggiornamento futuro delle risorse.

Come contribuire alla documentazione

Per inviare suggerimenti, vai al repository della risorsa specifica e apri una nuova segnalazione (issue).

Se invece vuoi suggerire modifiche puntuali, come correzioni di refusi, formattazione o linguaggio:

1. vai alla pagina di documentazione su cui vuoi proporre delle modifiche
2. clicca sul collegamento “Proponi una modifica a questa pagina” (presente in fondo a ogni pagina del sito, prima del footer) per proporre modifiche alle pagine dei modelli su Designers Italia, oppure sul collegamento “Sorgente” (presente in alto a destra su ogni pagina, nell’header) per proporre modifiche alla documentazione operativa dei modelli su Docs Italia
3. edita il file con le modifiche che vuoi proporre, ponendo attenzione alla gerarchia dei contenuti e le indentazioni
4. invia una una richiesta di contribuzione (pull request) verso il repository che contiene il sorgente della documentazione.

Come contribuire ai documenti di architettura dell'informazione

Per suggerire modifiche all'architettura, alle tipologie di contenuto, alle tassonomie o correggere refusi, apri una nuova segnalazione sul repository GitHub di Designers Italia e assicurati di specificare il modello al quale vuoi contribuire, il dettaglio delle modifiche e il razionale alla base dei tuoi suggerimenti.

Come contribuire alle risorse di design

Per inviare i tuoi contributi dedicati alla progettazione delle interfacce dei modelli di sito e servizi:

1. copia nei draft del tuo profilo Figma la versione più recente del file di design di interesse dalla Figma Community;
2. crea un nuovo file in Figma contente solo gli elementi che hai modificato e che vuoi proporre nel tuo contributo;
3. apri una segnalazione sul repository GitHub della risorsa di riferimento, o proponi il contributo nei commenti di una discussione già esistente sul tema di interesse, evidenziando intenzioni e possibilità;
4. nella segnalazione o nel commento, condividi l'indirizzo al file Figma realizzato, impostando i permessi di accesso in sola lettura (view only). In questo modo potremo valutare più velocemente il tuo contributo.

Nelle lavorazioni poni particolare attenzione al rispetto dei fondamenti del design system del Paese e alla compabilità della proposta di contributo con la conversione del kit verso altri formati aperti; in particolare utilizziamo lo strumento fig2sketch per generare in automatico la conversione del kit nel formato Sketch a ogni rilascio nel repository dedicato. Scrivi nella segnalazione se hai testato la conversione della proposta.

Come contribuire alle risorse di sviluppo

Per inviare contributi per i templates HTML statici e i temi CMS del modello Comuni e del modello Scuole, segui le indicazioni di contribuzione per le risorse di sviluppo.

Nelle lavorazioni poni attenzione al rispetto dei fondamenti del design system del Paese. Può esserti utile il "workflow per migliorare lo sviluppo dei componenti" del fondamento Accessibilità.

Note sulla lingua

• Puoi trovare frequentemente discussioni in lingua inglese perché considerata lingua franca dei progetti open source, in particolare per i temi di design e sviluppo
• Per le discussioni relative alla documentazione e ai contenuti, ci sembra però ragionevole usare la lingua italiana per le contribuzioni
• Sono ovviamente benvenuti in maniera paritetica contributi in italiano e in inglese