From c565029962be8f812555c6f9d782a5053e0e3942 Mon Sep 17 00:00:00 2001
From: Stephen Finucane <stephen@that.guru>
Date: Wed, 26 Apr 2017 22:45:33 +0100
Subject: docs: Split API docs into their own section

Third time lucky. There are two changes:

- Add a new 'clients' section to the usage doc, allowing us to remove a
  lot of the API nitty gritty stuff from the users guide. This makes
  more sense as users don't really care what API method they're using -
  only what application).

- Change the API docs from the developers guide into a quick start
  section, allowing us to greatly expand the REST API docs to include
  information on pagination, authentication, etc.

Signed-off-by: Stephen Finucane <stephen@that.guru>
---
 docs/index.rst | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

(limited to 'docs/index.rst')

diff --git a/docs/index.rst b/docs/index.rst
index 27e55ac..29f2c9d 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -27,8 +27,7 @@ of community projects.
    usage/design
    usage/delegation
    usage/headers
-   usage/rest
-   usage/xmlrpc
+   usage/clients
 
 .. _deployment-docs:
 
@@ -39,7 +38,7 @@ of community projects.
    deployment/installation
    deployment/upgrading
 
-.. development-docs:
+.. _development-docs:
 
 .. toctree::
    :maxdepth: 2
@@ -48,8 +47,16 @@ of community projects.
    development/contributing
    development/installation
    development/releasing
-   development/rest
-   development/xmlrpc
+   development/api
+
+.. _api-docs:
+
+.. toctree::
+   :maxdepth: 2
+   :caption: API Documentation
+
+   api/rest
+   api/xmlrpc
 
 .. _release-note-docs:
 
-- 
cgit v1.2.3