How to contribute to jMonkeyEngine
First and foremost, you have to familiarize yourself with Git & GitHub. Dig through help.github.com, try.github.io and the gh cheat sheet if these are new topics for you. If you'd like to contribute with something other than code, just tell us about it on the forum.
Communication always comes first. All code changes and other contributions should start with the forum. Make a thread to explain your change and show us the important bits of your code. If the code is too long to be posted within the forum’s code tags, please paste your code in a Gist or pastebin and link to the submission in your thread. You are required to register on our website in order to create threads. (We do support login via GitHub though).
Check out the Projects tab, where the team has prioritized issues that you as a new contributor can undertake that will familiarize you to the workflow of contributing. This highlights some issues the team thinks would be a good start for new contributors but you are free to contribute on any other issues or integration you wish.
When you're ready to submit your code, just make a pull request.
- Do not commit your code until you have received proper feedback.
- In your commit log message, please refer back to the originating forum thread (example) for a ‘full circle’ reference. Also please reference related issues by typing the issue hashtag.
- When committing, always be sure to run an update before you commit. If there is a conflict between the latest revision and your patch after the update, then it is your responsibility to track down the update that caused the conflict and determine the issue (and fix it). In the case where the breaking commit has no thread linked (and one cannot be found in the forum), then the contributor should contact an administrator and wait for feedback before committing.
- If your code is committed and it introduces new functionality, please edit the wiki accordingly. We can easily roll back to previous revisions, so just do your best; point us to it and we’ll see if it sticks!
p.s. We will try hold ourselves to a certain standard when it comes to GitHub etiquette. If at any point we fail to uphold this standard, let us know.
Developers in the Contributors team can push directly to Main instead of submitting pull requests, however for new features it is often a good idea to do a pull request as a means to get a last code review.
Customs around integration, branching, tagging, and releases
- Most pull requests are integrated directly into the master branch of the repository.
- Integrators should note, unless the history of the pull request is important, it should be integrated to a single commit using “squash and merge”. If the history is important, favor “rebase and merge”. Don’t create a merge commit unless GitHub cannot rebase the PR.
- For each major release (such as v3.0 or v3.3), an appropriately named release branch is created in the repository.
- For each minor (or “dot-dot”) release (such as v3.2.3), an appropriately named tag is created in the repository.
- In general, library changes that plausibly might break existing apps appear only in major releases, not minor ones.
Building the engine
- Install Gradle
- Navigate to the project directory and run 'gradle build' from command line to build the engine.
general testing tips? WIP
We generally abide by the standard Java Code Conventions. Besides that, just make an effort to write elegant code:
- Handles errors gracefully
- Only reinvents the wheel when there is a measurable benefit in doing so.
- Has consistent naming conventions.
- Has comments around ugly code explaining why it is ugly.
- Compiles (or runs if interpreted) without warnings.
- Start by searching the forum and GH issue tracker for duplicates.
- Create a new issue, explaining the problem in proper detail (templates pending).
- How to edit the wiki.
- How to edit JavaDocs - WIP