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

Desenvolvedores que mostrar determinação e consistência em suas contribuições para o projeto, podem ser convidados a critério de líderes a juntar-se à equipe. Não há nenhum processo formal de candidatura. Por favor não pedi para ser da equipe, nós que iremos perguntar a você.

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.