コントリビューション ガイドライン

There will always be a need for developers to help us improve SpongeAPI. There is no such thing as a perfect project and things can always be improved. If you are a developer and are interested in helping then please do not hesitate. Just make sure you follow our guidelines.

General steps

  1. 開発環境の準備 で説明したように、ワークスペースをセットアップします。
  2. Make sure you’re familiar with Git and GitHub. If your knowledge needs a refresh, take a look here: How to Git(Hub)
  3. Check for existing issues in the SpongeAPI, SpongeCommon, SpongeForge, SpongeVanilla, 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.

注釈

Please don’t submit pull request for small changes under 20 lines. Instead, join #sponge on IRC (irc.esper.net) or join #spongedev on IRC (irc.esper.net) and we’ll change it together with the other smaller changes.

  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 WIP (work in process) pull request prefixed with [WIP] early so we can already start reviewing them.
  2. プロジェクトをフォークし、クローンして追加したブランチで変更を行います。
  3. Test your changes (make sure it compiles!), commit and push them to your fork.
  4. Submit the pull request with a short summary what you’ve changed and why it should be changed in that way.
  5. If you make additional changes, push new commits to your branch. Do not squash your changes, that makes it extremely hard to see what you’ve changed compared to the previous version of your pull request.
  6. 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!

ちなみに

If you’re unsure which branch you should base your work on, read about our Versioning System and Repository Branch Layout before submitting your PR.