#720: addressing PR feedback on the snapshot dependencies documentation.

Author: snazha-blkio

README.rst

@@ -109,7 +109,10 @@ demonstrates a number of core features of Ethereum with web3j, including:
 Getting started
 ---------------
 
-Add the relevant dependency to your project:
+Typically your application should depend on release versions of web3j, but you may also use snapshot dependencies
+for early access to features and fixes, refer to the  `Snapshot Dependencies`_ section.
+
+| Add the relevant dependency to your project:
 
 Maven
 -----
@@ -151,40 +154,6 @@ Android:
    compile ('org.web3j:core:3.3.1-android')
 
 
-Snapshot dependencies
----------------------
-
-If you would like to use snapshots instead please add a new maven repository pointing to:
-
-::
-
-  https://oss.sonatype.org/content/repositories/snapshots
-
-Please refer to the `maven <https://maven.apache.org/guides/mini/guide-multiple-repositories.html>`_ or `gradle <https://maven.apache.org/guides/mini/guide-multiple-repositories.html>`_ documentation for further detail.
-
-Sample gradle configuration:
-
-.. code-block:: groovy
-
-   repositories {
-      maven {
-         url "https://oss.sonatype.org/content/repositories/snapshots"
-      }
-   }
-
-Sample maven configuration:
-
-.. code-block:: xml
-
-   <repositories>
-     <repository>
-       <id>sonatype-snasphots</id>
-       <name>Sonatype snapshots repo</name>
-       <url>https://oss.sonatype.org/content/repositories/snapshots</url>
-     </repository>
-   </repositories>
-
-
 Start a client
 --------------
 
@@ -603,6 +572,44 @@ To run the integration tests:
 
    $ ./gradlew  -Pintegration-tests=true :integration-tests:test
 
+
+.. _snapshot-dependencies:
+
+Snapshot Dependencies
+---------------------
+
+Snapshot versions of web3j follow the ``<major>.<minor>.<build>-SNAPSHOT`` convention, for example: 3.6.0-SNAPSHOT.
+
+| If you would like to use snapshots instead please add a new maven repository pointing to:
+
+::
+
+  https://oss.sonatype.org/content/repositories/snapshots
+
+Please refer to the `maven <https://maven.apache.org/guides/mini/guide-multiple-repositories.html>`_ or `gradle <https://maven.apache.org/guides/mini/guide-multiple-repositories.html>`_ documentation for further detail.
+
+Sample gradle configuration:
+
+.. code-block:: groovy
+
+   repositories {
+      maven {
+         url "https://oss.sonatype.org/content/repositories/snapshots"
+      }
+   }
+
+Sample maven configuration:
+
+.. code-block:: xml
+
+   <repositories>
+     <repository>
+       <id>sonatype-snasphots</id>
+       <name>Sonatype snapshots repo</name>
+       <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+     </repository>
+   </repositories>
+
 Thanks and credits
 ------------------