From 88a759a9ddeee282ef5e8ef8aa1342666f8d308c Mon Sep 17 00:00:00 2001
From: Gregor Middell <gregor@middell.net>
Date: Thu, 17 Dec 2015 12:28:54 +0100
Subject: [PATCH] Document the release process

---
 RELEASE-HOWTO.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 RELEASE-HOWTO.md

diff --git a/RELEASE-HOWTO.md b/RELEASE-HOWTO.md
new file mode 100644
index 000000000..42b134908
--- /dev/null
+++ b/RELEASE-HOWTO.md
@@ -0,0 +1,44 @@
+## Setup GPG
+
+Releasing artifacts to Maven Central requires signing them. Make sure gpg is set up:
+
+[http://central.sonatype.org/pages/working-with-pgp-signatures.html](http://central.sonatype.org/pages/working-with-pgp-signatures.html).
+
+## Setup Maven
+
+In `$HOME/.m2/settings.xml`, add credentials for accessing
+[Sonatype's OSS Repository](https://oss.sonatype.org/):
+
+    <settings>
+      <servers>
+        <server>
+          <id>ossrh-interedition</id>
+          <username>interedition</username>
+          <password>...</password>
+        </server>
+      </servers>
+    </settings>
+
+## Update changelog
+
+Edit `changelog.txt`.
+
+## Update POMs and site to reflect new release version
+
+    mvn versions:set -DnewVersion=1.2.3
+
+Edit `site/grunt/jade.js` and update `dist.options.data.version`.
+
+## Deploy artifacts to staging area
+
+Activate the `release` profile in order to attach Javadocs and sources to build artifacts.
+
+    mvn clean deploy -P release
+
+## Commit and push released version to VCS and tag release
+
+Push to Github and create a release.
+
+## Release successfully staged artifacts
+
+    mvn nexus-staging:release