======================= Contribution Guidelines ======================= .. warning:: This documentation refers to an outdated SpongeAPI version and is no longer actively maintained. While the code examples still work for that API version, the policies, guidelines, and some links may have changed. Please refer to the latest version of the documentation for those. 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. .. note:: 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. General steps ============= 1. Setup your workspace as described in :doc:`../../preparing/index`. #. Make sure you're familiar with Git and GitHub. If your knowledge needs a refresh, take a look here: :doc:`howtogit` #. 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. .. note:: 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. 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 WIP (work in process) pull request prefixed with ``[WIP]`` early so we can already start reviewing them. #. Fork the project, clone it and make your changes in an extra branch. #. Test your changes (make sure it compiles!), commit and push them to your fork. #. Submit the pull request with a short summary what you've changed and why it should be changed in that way. #. 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. #. 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! .. tip:: If you're unsure which branch you should base your work on, read about our :doc:`versioning` before submitting your PR.