diff --git a/docs/source/release-notes.rst b/docs/source/release-notes.rst
index 9ce650aaf7..133ca26f20 100644
--- a/docs/source/release-notes.rst
+++ b/docs/source/release-notes.rst
@@ -6,16 +6,25 @@ Here are brief summaries of what's changed between each snapshot release.
 Milestone 7
 -----------
 
-* Developer experience:
+* With thanks to *Thomas Schroeter* ``NotaryFlow`` is now idempotent.
 
-    * Improved API to ``NetworkMapCache`` by removing the duplicated gte() and moved many getter implementations from
-      the ``InMemoryNetworkMapCache`` to the ``NetworkMapCache`` because they were generic implementations. ``regulators``.
-      also renamed ``regulatorNodes`` to be consistent.
-    * Improved client observable API by merging two specific folds into a general fold function and added a buffer to
-      the rx observable to avoid flooding the UI thread.
-    * CorDapp types can be used in parameters to ``startFlowDynamic``.
-    * The CorDapp template now has a Java example that parallels the Kotlin one for developers more comfortable with
-      Java. ORM support added to the pair of examples.
+* Explorer:
+
+    * The GUI for the explorer now shows other nodes on the network map and the transactions between them.
+    * Map resolution increased and allows zooming and panning.
+    * Video demonstration of the Node Explorer: `https://www.corda.net/2017/01/03/the-node-explorer/`_.
+
+* The CorDapp template now has a Java example that parallels the Kotlin one for developers more comfortable with Java.
+  ORM support added to the pair of examples.
+
+* Demos:
+
+    * Added the Bank of Corda demo - a demo showing a node (Bank of Corda) acting as an issuer of Cash, and a client
+      driver providing both Web and RPC access to request issuance of cash.
+    * Demos now use RPC to communicate with the node from the webserver. This brings the demos more in line with how
+      interaction with nodes is expected to be. The demos now treat their webservers like clients. This will also allow
+      for the splitting of the webserver from the node for milestone 8.
+    * Added a SIMM valuation demo integration test to catch regressions.
 
 * Security:
 
@@ -24,24 +33,8 @@ Milestone 7
       This also means that nodes or RPC users cannot pretend to be other nodes or RPC users.
     * The node now does host verification of any node that connects to it and prevents man in the middle attacks.
 
-* Demos:
-
-    * Demos now use RPC to communicate with the node from the webserver. This brings the demos more in line with how
-      interaction with nodes is expected to be. The demos now treat their webservers like clients. This will also allow
-      for the splitting of the webserver from the node for milestone 8.
-    * Added the Bank of Corda demo - a demo showing a node (Bank of Corda) acting as an issuer of Cash, and a client
-      driver providing both Web and RPC access to request issuance of cash.
-    * Added a SIMM valuation demo integration test to catch regressions.
-
-* Explorer:
-
-    * The GUI for the explorer now shows other nodes on the network map and the transactions between them.
-    * Map resolution increased and allows zooming and panning.
-    * Video demonstration of the Node Explorer: `https://www.corda.net/2017/01/03/the-node-explorer/`_.
 
 * Improvements:
-
-    * With thanks to *Thomas Schroeter* ``NotaryFlow`` is now idempotent.
     * Added a custom serialiser for CompositeKey.
     * Added commonName extension method to X500Name and helper class for x509 cert factories.
     * Vault updates now contain full StateAndRef which allows subscribers to check whether the update contains
@@ -49,7 +42,7 @@ Milestone 7
     * Cash balances are calculated using aggregate values to prevent iterating through all states in the vault, which
       improves performance.
     * Multi-party services, such as notaries, are now load balanced and represented as a single ``Party`` object.
-    * The Notary Change flow now supports encumberances.
+    * The Notary Change flow now supports encumbrances.
 
 Milestone 6
 -----------