summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authormd_5 <git@md-5.net>2014-12-18 11:00:52 +1100
committermd_5 <git@md-5.net>2014-12-18 11:00:52 +1100
commit6a2f313af1e63172e52d91094d29f0a9a40d987a (patch)
treedbc1b1a0a8a022c26ee41e8c60d4875869388657 /README.md
parentc638ba4499ee77afab31fa82ea569a2253e41c79 (diff)
downloadbukkit-6a2f313af1e63172e52d91094d29f0a9a40d987a.tar
bukkit-6a2f313af1e63172e52d91094d29f0a9a40d987a.tar.gz
bukkit-6a2f313af1e63172e52d91094d29f0a9a40d987a.tar.lz
bukkit-6a2f313af1e63172e52d91094d29f0a9a40d987a.tar.xz
bukkit-6a2f313af1e63172e52d91094d29f0a9a40d987a.zip
Add initial README rewrite.
Diffstat (limited to 'README.md')
-rw-r--r--README.md27
1 files changed, 18 insertions, 9 deletions
diff --git a/README.md b/README.md
index a51766e6..bfb20177 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,25 @@
Bukkit
======
+A plugin API for [Minecraft](https://minecraft.net/) servers, currently maintained by [SpigotMC](http://www.spigotmc.org/).
-A Minecraft Server API.
-
-Website: [http://bukkit.org](http://bukkit.org)
-Bugs/Suggestions: [http://leaky.bukkit.org](http://leaky.bukkit.org)
-Contributing Guidelines: [CONTRIBUTING.md](https://github.com/Bukkit/Bukkit/blob/master/CONTRIBUTING.md)
+Bug Reporting
+-------------
+The development team is very open to both bug and feature requests / suggestions. You can submit these on the [JIRA Issue Tracker](http://hub.spigotmc.org/jira/).
Compilation
-----------
+Bukkit is a Java program which uses [Maven 3](http://maven.apache.org/) for compilation. To compile fresh from Git, simply perform the following steps:
+* Install Maven and Git using your preferred installation methods.
+* `git clone https://hub.spigotmc.org/stash/scm/spigot/bukkit.git`.
+* `mvn clean install`.
+
+Some IDEs such as [NetBeans](https://netbeans.org/) can perform these steps for you. Any Maven capable Java IDE can be used to develop with Bukkit, however the current team's personal preference is to use NetBeans.
-We use maven to handle our dependencies.
-
-* Install [Maven 3](http://maven.apache.org/download.html)
-* Check out this repo and: `mvn clean install`
+Contributing
+------------
+Contributions of all sorts are welcome. To manage community contributions, we use the pull request functionality of Stash. In to gain access to Stash and create a pull request, you will first need to perform the following steps:
+* Create an account on [JIRA](http://hub.spigotmc.org/jira/).
+* Fill in the [SpigotMC CLA](http://www.spigotmc.org/go/cla) and wait up to 24 hours for your Stash account to be activated. Please ensure that your username and email addresses match.
+* Log into Stash using your JIRA credentials.
+
+Once you have performed these steps you can create a fork, push your code changes, and then submit it for review.