Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Updated README.md with more coding and pull request conventions and t…

…ips to get your pull request accepted.
  • Loading branch information...
commit fc9a43c6e43c6d3fdbec1a48326f09d6fbc5627f 1 parent 4ed32f8
Warren EvilSeph authored

Showing 1 changed file with 18 additions and 4 deletions. Show diff stats Hide diff stats

  1. +18 4 README.md
22 README.md
Source Rendered
@@ -20,11 +20,25 @@ Coding and Pull Request Conventions
20 20 * We generally follow the Sun/Oracle coding standards.
21 21 * No tabs; use 4 spaces instead.
22 22 * No trailing whitespaces.
23   -* No 80 column limit or midstatement newlines.
24   -* No CRLF lineendigs, LF only, put your gits 'core.autocrlf' on 'true'
25   -* Proper javadoc for each method added/changed to describe what it does.
  23 +* No CRLF line endings, LF only, put your gits 'core.autocrlf' on 'true'.
  24 +* No 80 column limit or 'weird' midstatement newlines.
26 25 * 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!).
27 26 * No merges should be included in pull requests unless the pull request's purpose is a merge.
28 27 * Pull requests should be tested (does it compile? AND does it work?) before submission.
  28 +* Any major additions should have documentation ready and provided if applicable (this is usually the case).
  29 +* 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).
  30 +* Try to follow test driven development where applicable.
29 31
30   -Follow the above conventions if you want your pull requests accepted.
  32 +Tips to get your pull request accepted
  33 +-----------
  34 +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.
  35 +
  36 +* Make sure you follow all of our conventions to the letter.
  37 +* Make sure your code compiles under Java 5.
  38 +* Provide proper JavaDocs where appropriate.
  39 +* Provide proper accompanying documentation where appropriate.
  40 +* Test your code.
  41 +* Make sure to follow coding best practises.
  42 +* Provide a test plugin binary and source for us to test your code with.
  43 +* Your pull request should link to accompanying pull requests.
  44 +* The description of your pull request should provide detailed information on the pull along with justification of the changes where applicable.

0 comments on commit fc9a43c

Please sign in to comment.
Something went wrong with that request. Please try again.