Joel reflect docs changes.

* Moves upgrade notes to be more visible.
* Clarifies that only the first two tutorials are related and form a sequence.

docs/source/building-a-cordapp-index.rst

@@ -6,6 +6,7 @@ CorDapps
 
    cordapp-overview
    writing-a-cordapp
+   upgrade-notes
    cordapp-build-systems
    building-against-master
    api-index

docs/source/release-process-index.rst

@@ -6,6 +6,5 @@ Release process
 
    release-notes
    changelog
-   upgrade-notes
    codestyle
    testing

docs/source/tutorials-index.rst

@@ -1,11 +1,23 @@
 Tutorials
 =========
 
+This section is split into two parts.
+
+The Hello, World tutorials should be followed in sequence and show how to extend the Java or Kotlin CorDapp Template
+into a full CorDapp.
+
 .. toctree::
    :maxdepth: 1
 
    hello-world-introduction
    tut-two-party-introduction
+
+The remaining tutorials cover individual platform features in isolation. They don't depend on the code from the Hello,
+World tutorials, and can be read in any order.
+
+.. toctree::
+   :maxdepth: 1
+
    tutorial-contract
    tutorial-test-dsl
    contract-upgrade

docs/source/upgrade-notes.rst

@@ -1,5 +1,5 @@
-Upgrade notes
-=============
+Upgrading a CorDapp to a new version
+====================================
 
 These notes provide instructions for upgrading your CorDapps from previous versions, starting with the upgrade from our
 first public Beta (:ref:`Milestone 12 <changelog_m12>`), to :ref:`V1.0 <changelog_v1>`.