From 607e24b2faa9c7d89a0b8ffb67b0a167a109d383 Mon Sep 17 00:00:00 2001 From: Stephen Gold Date: Tue, 17 Sep 2019 13:12:08 -0700 Subject: [PATCH] rm docs from v3.1 branch to reduce risk from issues like #1160 --- CONTRIBUTING.md | 59 ------------------------------------------------- README.md | 49 ---------------------------------------- 2 files changed, 108 deletions(-) delete mode 100644 CONTRIBUTING.md delete mode 100644 README.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 82ffeb4e8..000000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,59 +0,0 @@ -# How to contribute to jMonkeyEngine - -First and foremost, you have to familiarize yourself with Git & GitHub. Dig through -[help.github.com](https://help.github.com/), [try.github.io](http://try.github.io/) and the [gh cheat sheet](https://github.com/tiimgreen/github-cheat-sheet/blob/master/README.md) 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 - -Communication always comes first. **All** code changes and other contributions should start with the [forum](http://hub.jmonkeyengine.org/). 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). - -### New Contributors - -When you're ready to submit your code, just make a [pull request](https://help.github.com/articles/using-pull-requests). - -- 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](https://help.github.com/articles/closing-issues-via-commit-messages) 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](http://www.defmacro.org/2013/04/03/issue-etiquette.html) when it comes to GitHub etiquette. If at any point we fail to uphold this standard, let us know. - -#### Core Contributors - -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. - -## Building the engine - -1. Install [Gradle](http://www.gradle.org/) -2. Navigate to the project directory and run 'gradle build' from command line to build the engine. - -## Best Practices - -### Git essentials - -- [Creating good pull requests](http://seesparkbox.com/foundry/creating_good_pull_requests) -- [How to write the perfect pull request](https://github.com/blog/1943-how-to-write-the-perfect-pull-request?utm_content=buffer0eb16&utm_medium=social&utm_source=twitter.com&utm_campaign=buffer) - -### Testing - -general testing tips? WIP - -### Code Quality - -We generally abide by the standard Java Code Conventions. Besides that, just make an effort to write elegant code: - - 1. Handles errors gracefully - 2. Only reinvents the wheel when there is a measurable benefit in doing so. - 3. Has consistent naming conventions. - 4. Has comments around ugly code explaining why it is ugly. - 5. Compiles (or runs if interpreted) without warnings. - -## Reporting bugs - - 1. Start by searching the [forum](http://hub.jmonkeyengine.org) and GH issue tracker for duplicates. - 2. Create a new issue, explaining the problem in proper detail (templates pending). - -## Documentation - -- How to edit the wiki - WIP -- How to edit JavaDocs - WIP diff --git a/README.md b/README.md deleted file mode 100644 index fc26d8c29..000000000 --- a/README.md +++ /dev/null @@ -1,49 +0,0 @@ -jMonkeyEngine -============= - -[![Build Status](https://travis-ci.org/jMonkeyEngine/jmonkeyengine.svg?branch=master)](https://travis-ci.org/jMonkeyEngine/jmonkeyengine) - -jMonkeyEngine is a 3D game engine for adventurous Java developers. It’s open source, cross platform and cutting edge. And it is all beautifully documented. The 3.0 branch is the latest stable version of the jMonkeyEngine 3 SDK, a complete game development suite. We'll be frequently submitting stable 3.0.x updates until the major 3.1 version arrives. - -The engine is used by several commercial game studios and computer-science courses. Here's a taste: - -![jME3 Games Mashup](http://i.imgur.com/hBehW2i.jpg) - - - [jME powered games on IndieDB](http://www.indiedb.com/engines/jmonkeyengine/games) - - [Maker's Tale](http://steamcommunity.com/sharedfiles/filedetails/?id=93461954t) - - [Boardtastic 2](https://play.google.com/store/apps/details?id=com.boardtastic.skateboarding) - - [Copod](http://herebeben.com/copod) - - [Attack of the Gelatinous Blob](http://attackofthegelatinousblob.com/) - - [Chaos](http://4realms.net/) - - [Mythruna](https://mythruna.com/) - - [PirateHell](http://www.desura.com/games/piratehell) - - [3089 (on steam)](http://store.steampowered.com/app/263360/) - - [3079 (on steam)](http://store.steampowered.com/app/259620/) - -## Getting started - -Go to https://github.com/jMonkeyEngine/sdk/releases to download the jMonkeyEngine SDK. -[Read the wiki](https://jmonkeyengine.github.io/wiki) for a complete install guide. Power up with some SDK Plugins and AssetPacks and you are off to the races. At this point you're gonna want to [join the forum](http://hub.jmonkeyengine.org/) so our tribe can grow stronger. - -Note: The master branch on GitHub is a development version of the engine and is NOT MEANT TO BE USED IN PRODUCTION, it will break constantly during development of the stable jME versions! - -### Technology Stack - - - Java - - NetBeans Platform - - Gradle - -Plus a bunch of awesome libraries & tight integrations like Bullet, Blender, NiftyGUI and other goodies. - -### Documentation - -Did you miss it? Don't sweat it, [here it is again](https://jmonkeyengine.github.io/wiki). - -### Contributing - -Read our [contribution guide](https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/CONTRIBUTING.md). - -### License - -New BSD (3-clause) License. In other words, you do whatever makes you happy! -