documentation/release.md: add instructions for releasing a new version

documentation/release.md

@@ -0,0 +1,45 @@
+# How to release a version of AreaShop
+Below the steps to follow for releasing a version of AreaShop are listed.
+
+## Pull the latest translations from Transifex
+**Setup:**
+1. Clone the [InteractiveMessengerTransifex](https://github.com/NLthijs48/InteractiveMessengerTransifex) repository
+2. Run `mvn package`
+	- The `target\InteractiveMessengerTransifex.jar` file should now be present
+
+**Pull translations:**
+1. Run `target/InteractiveMessengerTransifex.jar` using Java with the following arguments:
+	- **`download`**
+	- **<transifex api key>**, get from Transifex
+	- **`areashop`**, project name
+	- **`enyml`**, name of the file to download, this is the name AreaShop uses on Transifex
+	- **`./AreaShop/src/main/resources/lang`**, path to the `lang` directory in your clone of the AreaShop repository
+	- **`70`**, meaning only languages translated for at least 70% will get downloaded
+	- **`true`**, reformat the files to be suitable for using in the plugin
+	- **`./langHeader.yml`**, header to add to language file, this file is in the AreaShop repository
+	- **`<version>`**, release version to put in the header
+2. Commit the changed files in the AreaShop repository
+3. Push the commit to Github
+
+## Update the version number
+1. In `./AreaShop/pom.xml` update the `<version>` tag with the new version (following semantic versioning)
+2. In `./changelog.md` add notes about the features/fixes of this new version
+3. Commit the updated files
+4. Push the commit to Github
+5. Jenkins will build a new version and make it available on Maven
+
+## Uploading to distribution platforms
+The order is important, uploading to Github will trigger the update notification, but points people to Spigot
+1. Post a [resource update on Spigot](https://www.spigotmc.org/resources/areashop.2991/add-version)
+	- Use the changelog in the update message
+	- Indicate major features in the update title
+	- Update the supported Spigot versions if necessary
+2. Upload a [new file on Bukkit](https://dev.bukkit.org/projects/regionbuyandrent/files/upload)
+	- Use the changelog in the update message
+	- The file needs to be approved before it will be available for everyone
+3. Add a [new release on Github](https://github.com/NLthijs48/AreaShop/releases/new)
+	- Enter a tag like `v2.6.0`
+	- Enter a title like `AreaShop 2.6.0`
+	- Add the changelog
+	- Add the .jar file as `AreaShop.jar`
+