Make the intro bit a separate section rather than have a 'quick start' section that only tells you how to get started half way through.

README.rst

@@ -1,5 +1,5 @@
-Quick Start
-===========
+Introduction
+============
 
 Matrix is an ambitious new ecosystem for open federated Instant Messaging and
 VoIP[1].  The basics you need to know to get up and running are:
@@ -17,6 +17,9 @@ The overall architecture is::
       client <----> homeserver <=================> homeserver <-----> client
                 e.g. matrix.org:8080        e.g. mydomain.net:8080
 
+Quick Start
+===========
+
 To get up and running:
       
     - To simply play with an **existing** homeserver you can