Guias de contribuição

Sempre haverá demanda de desenvolvedores para nos ajudar a melhorar a SpongeApi. Não existe isso de projeto perfeito, sempre há coisas que podem ser melhoradas. Se você é um desenvolvedor e está interessado em ajudar então por favor, não hesite. Apenas certifique-se de seguir nossas 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 Preparando-se para o desenvolvimento.

  2. Certifique-se de estar familiarizado com o Git e com o GitHub. Se precisa refrescar seu conhecimento, dê uma olhada aqui: Como utilizar o Git(Hub)

  3. Verifique se há problemas existentes nos repositórios SpongeAPI, SpongeCommon, SpongeForge, SpongeVanilla, e SpongeDocs. Existe a possibilidade de mais alguém estar trabalhando na mesma coisa. Você também pode checar problemas marcados com “procura-se ajuda” para problemas que precisamos da sua ajuda.

Nota

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

  1. 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.

  2. fork no projeto, clone ele e faça suas alterações em um branch extra.

  3. Teste suas alterações (certifique-se de que compila!), comite e envie elas ao seu fork.

  4. Envie o pull request com um pequeno sumário do que você mudou e por que deve ser alterado dessa forma.

  5. Se você fizer mudanças adicionais, envie novos commits ao seu branch. Não misture suas mudanças, isso faz com que ver o que você mudou comparado à versão anterior do seu pull request fique algo extremamente difícil.

  6. Certifique-se de que seu PR está com base nas últimas mudanças do branch em que você está interessado em fazer o merge. Se você precisa fazer rebase, apenas peça!

Dica

Se você não estiver seguro sobre qual branch você deve basear seu trabalho, leia sobre nosso Organização dos branches do repositório antes de enviar sua PR.