Diretrizes de Contribuição

Vamos precisar sempre de programadores para nos ajudar a melhorar a Sponge Api. Não há nenhum projeto perfeito, há sempre coisas que podem ser melhoradas. Se és um programador e estás interessado, não exites. Tem apenas o cuidado de seguir as diretrizes.

Nota

Developers who show determination and consistency in their contributions to the project may be invited to join the Sponge Staff by Team Leaders, at their discretion. There is no formal application process. Please don’t ask to be staff, we’ll ask you.

Passos Gerais

1. Setup your workspace as described in Preparação para Desenvolvimento.

2. Certifica-te de que estás familiarizado com o Git e com o GitHub. Se precisas de refrescar os teus conhecimentos, dá uma olhadela aqui: Como Git(Hub)

3. Procura problemas existentes nos repositórios da SpongeAPI, SpongeCommon e SpongeDocs. Pode haver alguém que já esteja a trabalhar nesse mesmo problema. Poderás também também verificar os problemas marcados com «help wanted» <https://github.com/SpongePowered/SpongeAPI/labels/help%20wanted> para problemas que possam precisar de ajuda.

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. Faz fork do projeto, clona-o e faz as alterações num novo branch.

6. Testa as tuas alterações (verifica que compila). Depois faz commit e push para o teu fork.

7. Envia o pull request com uma pequena descrição do que é que alteraraste e porquê que deve ser alterado dessa maneira.

8. Se fizeres novas alterações, envia novos commits para o teu branch. Não juntes as alterações, isso faz com que seja extremamente difícil de ver o que mudaste comparando à versão anterior do teu pull request.

9. Make sure your PR is rebased to the latest changes of the branch you’re intending to merge it into. If you need help rebasing it, just ask!

Dica

If you’re unsure which branch you should base your work on, read about our Organização dos branches do repositório before submitting your PR.