TotalFreedomMod/CONTRIBUTING.md

53 lines
3.6 KiB
Markdown
Raw Normal View History

2013-07-11 12:18:10 +00:00
# Contributing to TotalFreedomMod #
TotalFreedomMod is a CraftBukkit server plugin designed primarily to support the [Official TotalFreedom Minecraft Server](http://totalfreedom.me/). However, it can be used in a variety of other configurations with minimal fuss.
2013-06-11 15:59:04 +00:00
2013-07-11 12:18:10 +00:00
For those who wish to contribute, we encourage you to fork the repository and submit pull requests. Below you will find guidelines that will explain this process in further detail.
2013-06-11 15:59:04 +00:00
2013-07-11 12:18:10 +00:00
## Getting Started ##
2013-06-11 15:59:04 +00:00
* Make sure you have a [GitHub account](https://github.com/signup/free)
* If the issue is a bug, submit a ticket for it, assuming one does not already exist.
* Clearly describe the issue including steps to reproduce it.
* Make sure you fill in the earliest version that you know has the issue.
* Fork the repository on GitHub
2013-07-11 12:18:10 +00:00
## Making Changes ##
2013-06-11 15:59:04 +00:00
* Create a topic branch from where you want to base your work.
* This is usually the master branch.
2013-07-11 12:18:10 +00:00
* Only target release branches if you are certain your addition must be on that branch.
* To quickly create a topic branch based on master; `git checkout -b contribution` - Please avoid working directly on the `master` branch.
2013-06-11 15:59:04 +00:00
* Make changes and commit where necessary.
* Check for unnecessary whitespace with `git diff --check` before committing.
* Make sure your commit messages are in line with those which are already made.
2013-07-11 12:18:10 +00:00
* Make sure your changes build (<b>and work!</b>).
2013-06-11 15:59:04 +00:00
2013-07-11 12:18:10 +00:00
## Tips - How To Get Your Pull Request Accepted ##
2013-06-18 14:34:35 +00:00
* Make sure your changes work and compile without difficulty.
2013-07-11 12:18:10 +00:00
* Make sure your change adds something useful, do not add commands to micromanage the server. (ie: Shorthands for a collection of commands)
* __Commands that make use of `org.bukkit.Server.dispatchCommand()` will probably be rejected.__
2013-06-11 15:59:04 +00:00
* Features must be in line the general idea of "Total Freedom".
2013-07-11 12:18:10 +00:00
* Changes must be directed towards the main "TotalFreedom" server. Adding names such as the name of your own TotalFreedom-like server will get your pull request denied.
2013-06-11 15:59:04 +00:00
* Do not add yourself to the developer list.
* Ensure that you use the correct whitespace-style. That is: 4 spaces as indentation.
2013-07-11 12:18:10 +00:00
* Please make sure your changes are written such as other features would be. Eg: commands have their own class and extend TFM_Command.
* __Make sure your code is written in the [Allman style](http://en.wikipedia.org/wiki/Indent_style#Allman_style).__
2013-06-11 15:59:04 +00:00
* Do not increment the version number.
2013-07-11 12:18:10 +00:00
* If you want to add multiple changes, please make one pull request per change. This way, it's easier to accept your changes faster and won't block the other changes if there is an issue with a specific line of code.
2013-06-11 15:59:04 +00:00
* Please make sure there are no bugs in your code.
* Please avoid having to add files in the main namespace where possible.
2013-07-11 12:18:10 +00:00
* Make sure all changes work before you commit these, this avoids having multiple unnecessary commits.
2013-06-18 14:34:35 +00:00
* Please refrain from using an excessive amount of commits. As few as possible is generally the best.
* Please do not spread your addition over several pull-requests.
2013-06-11 15:59:04 +00:00
2013-07-11 12:18:10 +00:00
## Submitting Your Changes ##
2013-06-11 15:59:04 +00:00
* Push your changes to a topic branch in your fork of the repository.
* Submit a pull request to this repository.
* Explain in detail what each one of your commits changes and point out any big changes.
* Wait as a developer evaluates your changes.
2013-07-11 12:18:10 +00:00
## Additional Resources ##
2013-06-11 15:59:04 +00:00
* [TotalFreedom information](http://totalfreedom.me)
* [TotalFreedom forums](http://totalfreedom.boards.net)
* [Bug tracker](https://github.com/TotalFreedom/TotalFreedomMod/issues)
* [General GitHub documentation](http://help.github.com/)
2013-06-18 14:34:35 +00:00
* [GitHub pull request documentation](http://help.github.com/send-pull-requests/)