Linee Guida di Contribuzione

Ci sarà sempre la necessita di sviluppatori che ci aiutano a migliorare la SpongeAPI. Non c’è niente come un progetto perfetto e le cose posso sempre essere migliorate. Se sei uno sviluppatore e sei interessato ad aiutarci, non esitare. Assicurati solo di seguire le nostre linee guida.

Nota

Gli sviluppatori che mostrano determinazione e costanza nei loro contributi al progetto potrebbero essere invitato a far parte dello staff di Sponge dai Leader del Team, a loro discrezione. Non c’è nessun processo formale di domanda. Si prega di non chiedere allo staff, te lo chiederemo noi.

Procedura Generale

1. Configura l’area di lavoro come descritto in Preparazione allo Sviluppo.

2. Assicurati di essere familiare con Git e Github. Se la tua conoscenza ha bisogno di una rinfrescata, dai un’occhiata qui: Come usare Git(Hub)

3. Check for existing issues in the SpongeAPI, SpongeCommon and SpongeDocs repositories. There is possibly someone else already working on the same thing. You can also check issues marked with «help wanted» for existing issues we need your help with.

Nota

Please don’t submit pull requests for small, non-functional changes such as fixing typos or renaming variable names. Instead, you can:

• join #spongedev on IRC (irc.esper.net) and we’ll change it together with the other smaller changes.

• Join our Discord Server and post on the #dev channel. Discord and IRC are linked, so don’t worry. We won’t miss your message!

• You can also add it to our list of Minor Issues on GitHub.

4. If the issue requires a bigger change you may want to submit the issues without the necessary changes first, so we can confirm the issue and know that you’re working on fixing it. You should also create a draft pull request or comment with ~wip so we can already start reviewing them.

5. Forka il progetto, clonalo e apporta le tue modifiche in un ramo extra.

6. Testa le tue modifiche (assicurati che si compilano!), effettua un commit, e pushali nel tuo fork.

7. Invia la richiesta di pool con un breve riassunto su cosa hai cambiato e il perché dovrebbe essere cambiato in quel modo.

8. Se effettui delle modifiche addizionali, pusha nuovi commit al tuo branch. Non sovrascrivere tutto, poichè fa diventare estremamente difficile vedere cosa hai cambiato rispetto alla versione precedente della tua richiesta di pull.

9. Assicurati che il tuo PR (Pool Request) sia aggiornato alle ultime modifiche del branch con cui intendi fonderlo. Se hai bisogno di aiuto a riguardo, basta chiedere!

Suggerimento

Se sei insicuro su quale branch dovresti basare il tuo lavoro, leggi Repository Branch Layout prima di inviare il tuo PR.