Merge pull request #2517 from ckan/2517-rtd-toc-redirects

show toc on front of docs, use rtd redirects

doc/contents.rst

@@ -4,7 +4,6 @@ Full table of contents
 
 .. toctree::
 
-   index
    user-guide
    sysadmin-guide
    maintaining/index

doc/contributing/reviewing.rst

@@ -41,8 +41,9 @@ with it. Nonetheless, here is an incomplete list of things to look for:
   plugins and themes.
 
   In general, any code that's documented in the reference sections of the
-  :doc:`API </api>`, :doc:`extensions </extensions/index>` or :doc:`theming
-  </theming/index>` needs to be considered. For example this includes changes
+  :doc:`API </api/index>`, :doc:`extensions </extensions/index>` or
+  :doc:`theming </theming/index>`
+  needs to be considered. For example this includes changes
   to the API actions, the plugin interfaces or plugins toolkit, the converter
   and validator functions (which are used by plugins), the custom Jinja2 tags
   and variables available to Jinja templates, the template helper functions,

doc/index.rst

@@ -1,42 +1,29 @@
+:orphan: true
+
 ========
 Overview
 ========
 
-Welcome to CKAN's documentation! These docs are organized into several guides,
-each guide serves a different audience of CKAN users or contributors:
-
-:doc:`user-guide`
-  The guide for people who will be using a CKAN site through its web interface,
-  explains how to use the web interface and its features.
 
-:doc:`sysadmin-guide`
-  The guide for people with a sysadmin account on a CKAN site,
-  explains how to use the sysadmin features of the CKAN web interface.
 
-:doc:`/maintaining/index`
-  The guide for people who will be maintaining a CKAN site, explains how to
-  install, upgrade and configure CKAN and its features and extensions.
-
-:doc:`/api/index`
-  The guide for API developers, explains how to write code that interacts with
-  CKAN sites and their data.
+Welcome to CKAN's documentation! These docs are organized into several guides,
+each guide serves a different audience of CKAN users or contributors.
 
-:doc:`/extensions/index`
-  The guide for extension developers, explains how to customize and extend
-  CKAN's features.
+.. toctree::
+  :maxdepth: 2
 
-:doc:`/theming/index`
-  The guide for theme developers, explains how to customize the appearance and
-  content of CKAN's web interface.
+  user-guide
+  sysadmin-guide
+  maintaining/index
+  api/index
+  extensions/index
+  theming/index
+  contributing/index
+  changelog
 
-:doc:`/contributing/index`
-  The guide for people who want to contribute to CKAN itself,
-  explains how to make all kinds of contributions to CKAN,
-  including reporting bugs, testing and QA, translating CKAN, helping with
-  CKAN's documentation, and contributing to the CKAN code.
+.. seealso::
 
-Finally, the :doc:`/changelog` documents the differences between CKAN releases,
-useful information for anyone who is using CKAN.
+   :doc:`contents`
 
 .. note::