diff options
author | EvilSeph <evilseph@gmail.com> | 2012-02-23 23:46:41 -0500 |
---|---|---|
committer | EvilSeph <evilseph@gmail.com> | 2012-02-24 00:09:53 -0500 |
commit | a7f0b70a3a4428b25eabf7ce3c943910b7b6487a (patch) | |
tree | 81826b362fe06d47541f44f517e74480144caaec /README.md | |
parent | 078e2511a51e52ffa666fcd7adb9e5f52e576404 (diff) | |
download | craftbukkit-a7f0b70a3a4428b25eabf7ce3c943910b7b6487a.tar craftbukkit-a7f0b70a3a4428b25eabf7ce3c943910b7b6487a.tar.gz craftbukkit-a7f0b70a3a4428b25eabf7ce3c943910b7b6487a.tar.lz craftbukkit-a7f0b70a3a4428b25eabf7ce3c943910b7b6487a.tar.xz craftbukkit-a7f0b70a3a4428b25eabf7ce3c943910b7b6487a.zip |
Updated README.md with more coding and pull request conventions and tips to get your pull request accepted.
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 21 |
1 files changed, 19 insertions, 2 deletions
@@ -22,15 +22,20 @@ Coding and Pull Request Conventions * We generally follow the Sun/Oracle coding standards. * No tabs; use 4 spaces instead. * No trailing whitespaces. -* No CRLF line endings, LF only, put your gits 'core.autocrlf' on 'true' +* No CRLF line endings, LF only, put your gits 'core.autocrlf' on 'true'. * No 80 column limit or 'weird' midstatement newlines. * The number of commits in a pull request should be kept to a minimum (squish them into one most of the time - use common sense!). * No merges should be included in pull requests unless the pull request's purpose is a merge. * Pull requests should be tested (does it compile? AND does it work?) before submission. +* Any major additions should have documentation ready and provided if applicable (this is usually the case). +* Most pull requests should be accompanied by a corresponding Leaky ticket so we can associate commits with Leaky issues (this is primarily for changelog generation on dl.bukkit.org). +* Try to follow test driven development where applicable. If you make changes or add net.minecraft.server classes it is mandatory to: * Get the files from the [mc-dev repo](https://github.com/Bukkit/mc-dev) - make sure you have the last version! +* Make a separate commit adding the new net.minecraft.server classes (commit message: "Added x for diff visibility" or so). +* Then make further commits with your changes. * Mark your changes with: * 1 line; add a trailing: `// CraftBukkit [- Optional reason]` * 2+ lines; add @@ -38,4 +43,16 @@ If you make changes or add net.minecraft.server classes it is mandatory to: * After: `// CraftBukkit end` * Keep the diffs to a minimum (*really* important) -Follow the above conventions if you want your pull requests accepted. +Tips to get your pull request accepted +----------- +Making sure you follow the above conventions is important, but just the beginning. Follow these tips to better the chances of your pull request being accepted and pulled. + +* Make sure you follow all of our conventions to the letter. +* Make sure your code compiles under Java 5. +* Provide proper JavaDocs where appropriate. +* Provide proper accompanying documentation where appropriate. +* Test your code. +* Make sure to follow coding best practises. +* Provide a test plugin binary and source for us to test your code with. +* Your pull request should link to accompanying pull requests. +* The description of your pull request should provide detailed information on the pull along with justification of the changes where applicable. |