updating development guidelines for release instructions

Author: aoberoi

DEVELOPING.md

@@ -32,23 +32,32 @@ This project's reference documentation is generated by Javadoc and resides in th
 Common tasks:
 
 *  `gradle javadoc` - generate the reference documentation locally.
-*  `gradle gh-pages` - update the hosted reference documentation on Github Pages (requires push privilege on `origin`
-    git remote)
 
 ### Releasing
 
-**TODO**
-
-*  dependencies
-    *  build
-    *  test
-    *  version bumping (needs to be a valid version that isn't already used)
-    *  ossrh signing keys
-*  automation
-    *  tagging
-    *  github pages uploading
-    *  maven central publishing
-    *  github release uploading
+In order to create a release, the following should be completed in order.
+
+1. Ensure all the tests are passing (`gradle check`) and that there is enough test coverage.
+1. Make sure you are on the `master` branch of the repository, with all changes merged/commited already.
+1. Update the version number in the source code and the README. See [Versioning](#versioning) for information
+   about selecting an appropriate version number. Files to change:
+   - src/main/java/com/opentok/constants/Version.java
+   - build.gradle
+   - README.md
+1. Commit the version number change with the message "Update to version x.x.x", substituting the new version number.
+1. Create a git tag: `git tag -a vx.x.x -m "Release vx.x.x"`
+1. Ensure that you have permission to update the OSSRH repository. The following system properties must be set:
+    - `ossrhUsername`
+    - `ossrhPassword`
+    - `signing.keyId`
+    - `signing.password`
+    - `signing.secretKeyRingFile`
+1. Run `gradle uploadArchives` to create a staging release.
+1. Login to [OSSRH](https://oss.sonatype.org/) and promote the staging release to a public release.
+1. Change the version number for future development by adding "-alpha.1" in each file, then make another commit with the
+   message "Begin development on next version".
+1. Push the changes to the source repository: `git push origin master`
+1. Create a zip for uploading the release to Github Releases
 
 ### IDE Integration
 
@@ -65,8 +74,7 @@ The project uses [semantic versioning](http://semver.org/) as a policy for incre
 work that will go into a future version, there should be a Milestone created in the Github Issues named with the version
 number (e.g. "v2.2.1").
 
-**TODO** During development the version number should end in "-pre". The version number is hardcoded into the class
-`com.opentok.constants.Version`, and also specified in `build.gradle`.
+During development the version number should end in "-alpha.x" or "-beta.x", where x is an increasing number starting from 1.
 
 ### Branches
 
@@ -94,4 +102,4 @@ Issues are labelled to help track their progress within the pipeline.
 
 ### Management
 
-When in doubt, find the maintainers and ask.
+When in doubt, find the maintainers and ask.

build.gradle

@@ -7,7 +7,7 @@ apply plugin: 'eclipse'
 group = 'com.tokbox'
 archivesBaseName = 'opentok-server-sdk'
 // TODO: how do we increment this before/after a release for deployment and development?
-version = '2.2.0-pre'
+version = '2.2.0-beta.1'
 
 sourceCompatibility = 1.6
 
@@ -57,18 +57,18 @@ signing {
     sign configurations.archives
 }
 
-ext.ossrhUsername = hasProperty('ossrhUsername') ? ossrhPassword : 'dummyuser'
+ext.ossrhUsername = hasProperty('ossrhUsername') ? ossrhUsername : 'dummyuser'
 ext.ossrhPassword = hasProperty('ossrhPassword') ? ossrhPassword : 'dummypass'
 uploadArchives {
     repositories {
         mavenDeployer {
             beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }
 
-            repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2/") {
+            repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2") {
               authentication(userName: ossrhUsername, password: ossrhPassword)
             }
 
-            snapshotRepository(url: "https://oss.sonatype.org/content/repositories/snapshots/") {
+            snapshotRepository(url: "https://oss.sonatype.org/content/repositories/snapshots") {
               authentication(userName: ossrhUsername, password: ossrhPassword)
             }