Passa al contenuto principale

Contribuire

Per rispondere efficacemente alle esigenze degli utenti, abbiamo progettato con cura le nostre linee guida per i contributi e ottimizzato i nostri template per garantire un'esperienza complessiva eccellente con il progetto.

Il nostro obiettivo è garantire che la documentazione e il nostro issue tracker siano ben strutturati, facili da navigare e ricercabili, così da trovare rapidamente ciò di cui hai bisogno. Seguendo le nostre linee guida, possiamo aiutarti molto più velocemente.

In questa sezione ti guidiamo attraverso i nostri processi.

Crea un'Issue​

  •   Qualcosa non funziona?

    Segnala un bug in Zenzic creando un'issue con una riproduzione del problema.

    Segnala un bug

  •   Informazioni mancanti nei docs?

    Segnala informazioni mancanti o potenziali incongruenze nella documentazione.

    Segnala un problema nei docs

  •   Vuoi proporre un'idea?

    Proponi una modifica, una richiesta di funzionalità o suggerisci un miglioramento.

    Richiedi una modifica

Contribuisci​

  •   Vuoi contribuire al codice?

    Contribuisci allo sviluppo di Zenzic aprendo una pull request.

    Apri una pull request

Checklist​

Prima di interagire all'interno del progetto, prenditi un momento per considerare le seguenti domande. In questo modo ti assicuri di utilizzare il template corretto e di fornire tutte le informazioni necessarie.

Le issue e i commenti sono permanenti

Tutto ciò che scrivi è permanente e rimarrà visibile a tutti — per sempre. Ti chiediamo quindi di essere sempre costruttivo e rispettoso, attenendoti al nostro [Codice di Condotta].

Prima di creare un'issue​

  • Stai usando il template di issue appropriato, o ne esiste un altro che si adatta meglio al contesto della tua richiesta?

  • Hai verificato se un bug simile o una richiesta analoga è già stata creata, o hai trovato qualcosa che potrebbe essere correlato?

  • Hai compilato ogni campo come richiesto e fornito tutte le informazioni aggiuntive di cui i maintainer hanno bisogno per comprendere la tua richiesta?

Prima di commentare​

  • Il tuo commento è pertinente all'argomento dell'issue corrente, oppure è meglio creare una nuova issue perché è solo vagamente correlato?

  • Il tuo commento aggiunge valore alla conversazione? È costruttivo e rispettoso verso la community e i maintainer? Potresti usare una reaction invece?

Contributi incompleti​

Abbiamo progettato con cura il nostro processo di contribuzione per garantire che le issue possano essere esaminate e gestite in modo efficiente. Ogni campo nei nostri template è strutturato per raccogliere i dettagli essenziali necessari a comprendere appieno la tua segnalazione.

Ci riserviamo il diritto di gestire le issue non conformi alle linee guida nel seguente modo:

Issue incomplete​

Ci riserviamo il diritto di chiudere le issue prive di informazioni essenziali, come riproduzioni mancanti o non conformi agli standard di qualità. Riapriremo un'issue una volta fornite le informazioni mancanti.

Domande come issue​

Ci riserviamo il diritto di chiudere le domande aperte come issue. L'issue tracker non è un luogo per domande, ma per segnalazioni di bug, problemi di documentazione e richieste di modifica dettagliate.

Issue duplicate​

Per mantenere una comunicazione organizzata ed efficiente, ci riserviamo il diritto di chiudere qualsiasi issue duplicata.

Issue riaperte​

Ci riserviamo il diritto di chiudere immediatamente le issue riaperte senza nuove informazioni.