From 8eb84612f20c9cb2c3c1efe8268fbdbc0adf6098 Mon Sep 17 00:00:00 2001
From: Daniel Wagner-Hall <daniel@matrix.org>
Date: Wed, 9 Dec 2015 16:17:58 +0000
Subject: [PATCH] Add index page

---
 specification/index.rst    | 25 +++++++++++++++++++++++++
 specification/intro.rst    | 25 -------------------------
 specification/targets.yaml |  5 ++++-
 3 files changed, 29 insertions(+), 26 deletions(-)
 create mode 100644 specification/index.rst

diff --git a/specification/index.rst b/specification/index.rst
new file mode 100644
index 00000000..4415c6e2
--- /dev/null
+++ b/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/
diff --git a/specification/intro.rst b/specification/intro.rst
index aa170be7..10f423b8 100644
--- a/specification/intro.rst
+++ b/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::
 
diff --git a/specification/targets.yaml b/specification/targets.yaml
index ca3aa215..98ca9322 100644
--- a/specification/targets.yaml
+++ b/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: