Guida ai contributi
Segnala bug, suggerisci feature e contribuisci con codice o documentazione.
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
AI contributions policy
We follow Zig’s Strict No LLM/No AI Policy. We do not accept contributions of any kind that are created or edited using generative artificial intelligence tools. This includes but is not limited to pull requests, issues, artwork and comments.
This policy relies on trust and the help of our maintainers. It does not guarantee that no AI-assisted code or prose exists in the project, but aims to discourage and prevent further AI-assisted contributions.
Grazie
Grazie per il tuo supporto e buon lavoro! 🌸
Disponibile anche in: English (inglese), Español (spagnolo)
Edit on GitHub