mirror of
https://github.com/PaperMC/Paper.git
synced 2024-09-12 15:08:27 +02:00
Updated README.md with more coding and pull request conventions and tips to get your pull request accepted.
This commit is contained in:
parent
078e2511a5
commit
a7f0b70a3a
21
README.md
21
README.md
@ -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.
|
||||
|
Loading…
Reference in New Issue
Block a user