Per la documentazione

Le indicazioni e i passi da seguire per contribuire alla documentazione del progetto Designers Italia.

Come contribuire
In breve

Contribuisci alla documentazione di Designers Italia proponendo modifiche, suggerimenti e integrazioni. Puoi proporre modifiche su tutte le schede della documentazione oppure inviare suggerimenti per migliorare e far evolvere il design system seguendo le indicazioni operative.

Metadati e link per approfondire

Contribuisci a questa documentazione

L'unica fonte di verità sulle risorse e sullo stato dei lavori del design system del Paese.

Puoi proporre modifiche, partecipare a discussioni, aprire segnalazioni e proporti per inviare contributi su tutte le schede della documentazione presente in questo sito.

Puoi ad esempio suggerire correzioni di stile e formattazione, migliorare il linguaggio dei contenuti, fare proposte migliorative che riguardano l'immaginario visivo o lo sviluppo stesso del sito e del suo software.

Premessa importante: assicurati di conoscere i fondamenti del design system del Paese.

Proponi una modifica di contenuto su una pagina

Ogni scheda di questa documentazione ha un collegamento al fondo, subito prima del piede, per proporre piccoli cambiamenti, integrazioni o correzioni di contenuti.

Agendo sul collegamento "Proponi una modifica a questa pagina" arrivi direttamente al file in formato yaml che controlla sia i contenuti di testo che i parametri di configurazione dei componenti che compongono la pagina. Puoi editare il file e proporre quindi una richiesta di contribuzione, una pull request, verso il repository che contiene il sorgente del sito. Il team di Designers Italia farà review quanto prima del tuo contributo.

Durante l'editing poni attenzione alla gerarchia dei contenuti nel file, la struttura del sito e la natura del formato file sono particolarmente sensibili alla corretta indentazione.

Esplora la lista di tutte le discussioni

L'intero codice sorgente del sito è disponibile sul repository italia/designers.italia.it ed è possibile contribuire sia lato contenuti che lato sviluppo.

Controlla in via preliminare se già esiste una discussione sul tema che ti interessa, o su un tema simile. Se già esiste, vai alla segnalazione dedicata e partecipa lasciando un commento. Se ti interessa lavorare a un contributo sul tema proponiti lasciando un commento nella discussione, evidenziando intenzioni e possibilità.

Apri una segnalazione

Se il tema di tuo interesse non è presente nella lista puoi proporre una nuova segnalazione. Ricorda di inserire nella nuova segnalazione tutti i dettagli che ritieni necessari per approfondire il tema, in modo da consentire alla community e al team di Designers Italia di avere un quadro chiaro e il più possibile completo della tua proposta.