Guida ai contributi

Questo progetto è mantenuto a beneficio della community e siamo grati per qualsiasi contributo che aiuti a migliorarlo. Chiediamo ai contributori di:

• Essere gentili con tutti 💛
• Seguire il Codice di Condotta
• Rispettare il tempo e l’impegno dei manutentori e degli altri contributori

Cosa contribuire

Accogliamo con favore e apprezziamo sia i contributi di codice che quelli non legati al codice, tra cui:

• Correzione errori di battitura
• Miglioramenti alla documentazione
• Revisioni delle pull request
• Richieste di feature
• Opinioni & suggerimenti

Anche i cambiamenti più piccoli possono aiutarci a liberare tempo per la manutenzione generale e a promuovere un’esperienza positiva, funzionale e accessibile per tutti ✨

Segnalazione di bug e richieste di funzionalità

Prima di aprire un issue, cerca tra le issue esistenti, comprese quelle chiuse.

Se esiste già:

• Usa le reazioni per dare visibilità all’issue
• Riserva i commenti a informazioni specifiche che potrebbero aiutare a risolvere il problema

Altrimenti:

Apri un issue contenente quanto segue:

Segnalazioni di bug:

• Più contesto possibile sul problema e su come e quando si verifica
• Passaggi per riprodurre il problema
• Report di crash, screenshot o log di errore, se possibile
• Versioni del software, se applicabile

Richieste di feature:

• Descrizione della feature o della modifica richiesta
• Motivazioni o contesto a supporto, se opportuno

Non possiamo garantire che le issue vengano risolte immediatamente, ma apprezziamo profondamente i suggerimenti e le segnalazioni e prendiamo in seria considerazione tutte le richieste.

Contributi al codice e alla documentazione

Se stai aggiungendo un nuovo tema, usa il nostro template

Implement your changes:

• Non aggiungere metafile non legati al progetto. Consulta il global gitignore per le pratiche migliori
• Fai una fork della repositoria ed esegui il commit delle modifiche su un branch tematico con un nome descrittivo
• Se possibile, raggruppa le modifiche in commit e branch logici e mirati
• Attieniti al formato del codice esistente, ad esempio messaggi di commit in minuscolo

Invia una PR:

• Invia una pull request alla repositoria principale con le tue modifiche e qualsiasi informazione di supporto, spiegazione o contesto che ritieni opportuno
• Se il tuo contributo è collegato a un’issue, fai riferimento ad essa nella descrizione della PR, ad es. fixes #123

Grazie

Grazie per il tuo supporto e buon lavoro! 🌸