Add index page

specification/index.rst

@@ -0,0 +1,25 @@
+Matrix Specification
+====================
+
+This specification has been generated from
+https://github.com/matrix-org/matrix-doc using
+https://github.com/matrix-org/matrix-doc/blob/master/scripts/gendoc.py as of
+revision ``{{git_version}}`` -
+https://github.com/matrix-org/matrix-doc/tree/{{git_rev}}.
+
+The following APIs are documented in this specification:
+
+- `Client-Server API <client_server.html>`_ version %CLIENT_RELEASE_LABEL% for writing Matrix clients.
+- `Server-Server API <server_server.html>`_ version %SERVER_RELEASE_LABEL% for writing servers which can federate with Matrix.
+- `Application Service API <application_service.html>`_ version %CLIENT_RELEASE_LABEL% for writing privileged plugins to servers.
+
+There is also an `introduction with overview <intro.html>`_, and some `appendices <appendices.html>`_.
+
+Any developments since the latest release can be found `here`__.
+
+.. __: https://matrix.org/speculator/spec/head/
+
+Before we formally started releasing the specification, the last working copy
+we had can be found `here`__.
+
+.. __: https://matrix.org/docs/spec/legacy/

specification/intro.rst

@@ -1,28 +1,3 @@
-Matrix Specification
-====================
-
-This specification has been generated from
-https://github.com/matrix-org/matrix-doc using
-https://github.com/matrix-org/matrix-doc/blob/master/scripts/gendoc.py as of
-revision ``{{git_version}}`` -
-https://github.com/matrix-org/matrix-doc/tree/{{git_rev}}.
-
-The following APIs are documented in this specification:
-
-- `Client-Server API <client_server.html>`_ version %CLIENT_RELEASE_LABEL% for writing Matrix clients.
-- `Server-Server API <server_server.html>`_ version %SERVER_RELEASE_LABEL% for writing servers which can federate with Matrix.
-- `Application Service API <application_service.html>`_ version %CLIENT_RELEASE_LABEL% for writing privileged plugins to servers.
-
-There are also some `appendices <appendices.html>`_.
-
-Any developments since the latest release can be found `here`__.
-
-Before we formally started releasing the specification, the last working copy
-we had can be found `here`__.
-
-.. __: https://matrix.org/speculator/spec/head/
-.. __: https://matrix.org/docs/spec/legacy/
-
 .. contents:: Table of Contents
 .. sectnum::
 

specification/targets.yaml

@@ -1,6 +1,9 @@
 targets:
   index:
-    files:  # the sort order of files to cat
+    files:
+      - index.rst
+  intro:
+    files:
       - intro.rst
   client_server:
     files: