diff --git a/content/realtime/usage.textile b/content/realtime/usage.textile
index 16086fd69d..903558129b 100644
--- a/content/realtime/usage.textile
+++ b/content/realtime/usage.textile
@@ -85,9 +85,23 @@ blang[ruby].
   ```
 
 blang[java].
-  The Realtime library for Java and Android is "hosted on Github":https://github.com/ably/ably-java and is downloadable as a JAR from "https://github.com/ably/ably-java/releases":https://github.com/ably/ably-java/releases or via "JCentre":https://bintray.com/ably-io/ably.
+  The Realtime library for Java and Android is "hosted on Github":https://github.com/ably/ably-java and can be used by adding one line to @build.gradle@ dependencies section.
 
-  Ensure the JAR is included in your classpath as follows:
+  For Java applications:
+
+  ```[java]
+  compile 'io.ably:ably-java:0.8.7'
+  ```
+
+  For Android apps:
+
+  ```[java]
+  compile 'io.ably:ably-android:0.8.7'
+  ```
+
+  In the above example a specific version of the library is referenced, however we recommend you check which is the latest stable version and always use that. Follow links to get the latest stable release for "Java":https://bintray.com/ably-io/ably/ably-java and "Android":https://bintray.com/ably-io/ably/ably-android.
+
+  Ensure the library is included in your classpath as follows:
 
   ```[java]
   import io.ably.lib.types.*;
diff --git a/content/rest/usage.textile b/content/rest/usage.textile
index 0676af05a9..041bd45951 100644
--- a/content/rest/usage.textile
+++ b/content/rest/usage.textile
@@ -106,9 +106,23 @@ blang[php].
   ```
 
 blang[java].
-  The REST library for Java and Android is "hosted on Github":https://github.com/ably/ably-java and is downloadable as a JAR from "https://github.com/ably/ably-java/releases":https://github.com/ably/ably-java/releases or via "JCentre":https://bintray.com/ably-io/ably.
+  The REST library for Java and Android is "hosted on Github":https://github.com/ably/ably-java and can be used by adding one line to @build.gradle@ dependencies section.
 
-  Ensure the JAR is included in your classpath as follows:
+  For Java applications:
+
+  ```[java]
+  compile 'io.ably:ably-java:0.8.7'
+  ```
+
+  For Android apps:
+
+  ```[java]
+  compile 'io.ably:ably-android:0.8.7'
+  ```
+
+  In the above example a specific version of the library is referenced, however we recommend you check which is the latest stable version and always use that. Follow links to get the latest stable release for "Java":https://bintray.com/ably-io/ably/ably-java and "Android":https://bintray.com/ably-io/ably/ably-android.
+
+  Ensure the library is included in your classpath as follows:
 
   ```[java]
   import io.ably.lib.types.*;
diff --git a/content/root/quick-start-guide.textile b/content/root/quick-start-guide.textile
index 2f377aa3d1..af066c316a 100644
--- a/content/root/quick-start-guide.textile
+++ b/content/root/quick-start-guide.textile
@@ -50,9 +50,24 @@ blang[php].
   bc[php]. require_once __DIR__ . '/../vendor/autoload.php';
 
 blang[java].
-  The Ably library for Java and Android is downloadable as a JAR from "https://github.com/ably/ably-java/releases":https://github.com/ably/ably-java/releases or via "JCentre":https://bintray.com/ably-io/ably.
+  The Ably library for Java and Android is "hosted on Github":https://github.com/ably/ably-java and can be used by adding one line to @build.gradle@ dependencies section.
 
-  Ensure the JAR is included in your classpath as follows:
+  For Java applications:
+
+  ```[java]
+  compile 'io.ably:ably-java:0.8.7'
+  ```
+
+  For Android apps:
+
+  ```[java]
+  compile 'io.ably:ably-android:0.8.7'
+  ```
+
+  In the above example a specific version of the library is referenced, however we recommend you check which is the latest stable version and always use that. Follow links to get the latest stable release for "Java":https://bintray.com/ably-io/ably/ably-java and "Android":https://bintray.com/ably-io/ably/ably-android.
+  
+
+  Ensure the library is included in your classpath as follows:
 
   ```[java]
   import io.ably.lib.types.*;
diff --git a/content/tutorials/history.textile b/content/tutorials/history.textile
index 0c87d659d1..e5b7f7c23c 100644
--- a/content/tutorials/history.textile
+++ b/content/tutorials/history.textile
@@ -45,11 +45,10 @@ blang[java].
 
   repositories {
     jcenter()
-      maven { url "https://raw.github.com/paddybyers/Java-WebSocket/mvn-repo/" }
   }
 
   dependencies {
-      compile 'io.ably:ably-java:0.8.4'
+      compile 'io.ably:ably-java:0.8.7'
   }
   ```
 
@@ -86,18 +85,7 @@ blang[android].
   ...
   dependencies {
       ...
-      compile 'io.ably:ably-java:0.8.4'
-  }
-  ```
-
-  Also add following repo for a sub-dependency in your project-level @gradle.build@ file.
-
-  ```[groovy]
-  allprojects {
-    repositories {
-        ...
-        maven { url "https://raw.github.com/paddybyers/Java-WebSocket/mvn-repo/" }
-    }
+      compile 'io.ably:ably-android:0.8.7'
   }
   ```
 
diff --git a/content/tutorials/publish-subscribe.textile b/content/tutorials/publish-subscribe.textile
index a1f9c83281..51bdee857e 100644
--- a/content/tutorials/publish-subscribe.textile
+++ b/content/tutorials/publish-subscribe.textile
@@ -28,11 +28,10 @@ blang[java].
 
   repositories {
     jcenter()
-      maven { url "https://raw.github.com/paddybyers/Java-WebSocket/mvn-repo/" }
   }
 
   dependencies {
-      compile 'io.ably:ably-java:0.8.4'
+      compile 'io.ably:ably-java:0.8.7'
   }
   ```
 
@@ -70,18 +69,7 @@ blang[android].
   ...
   dependencies {
       ...
-      compile 'io.ably:ably-java:0.8.4'
-  }
-  ```
-
-  Also add following repo for a sub-dependency in your project-level @gradle.build@ file.
-
-  ```[groovy]
-  allprojects {
-    repositories {
-        ...
-        maven { url "https://raw.github.com/paddybyers/Java-WebSocket/mvn-repo/" }
-    }
+      compile 'io.ably:ably-android:0.8.7'
   }
   ```
 
