Docs: restructure (#573)

The idea here is to make the docs have a more flat design that exposes more pages from the main index.

Author: Blendify

docs/Makefile

@@ -6,7 +6,7 @@ SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 SPHINXPROJ    = ReadtheDocsSphinxTheme
 SOURCEDIR     = .
-BUILDDIR      = _build
+BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".
 help:

docs/demo/api.rst

@@ -10,6 +10,11 @@
     :private-members:
     :special-members:
 
+Generated Index
+===============
+
+Part of the sphinx build process in generate and index file: :ref:`genindex`.
+
 
 Optional parameter args
 =======================

docs/demo/index.rst

@@ -1,19 +1,28 @@
 .. include:: ../README.rst
 
-Content
-=======
-
 .. toctree::
-   :caption: Theme
+   :caption: Theme Documentation
    :maxdepth: 2
 
    installing
    configuring
    changelog
    contributing
 
+
 .. toctree::
-   :caption: Demo
-   :maxdepth: 2
+    :maxdepth: 2
+    :numbered:
+    :caption: Demo Documents
+
+    demo/structure
+    demo/demo
+    demo/lists_tables
+    demo/api
+
+.. toctree::
+    :maxdepth: 3
+    :numbered:
+    :caption: This is an incredibly long caption for a long menu
 
-   demo/index
+    demo/long

docs/index.rst

@@ -10,7 +10,7 @@ if "%SPHINXBUILD%" == "" (
 set SPHINXOPTS=
 set SPHINXBUILD=sphinx-build
 set SOURCEDIR=.
-set BUILDDIR=_build
+set BUILDDIR=build
 set SPHINXPROJ=ReadtheDocsSphinxTheme
 
 if "%1" == "" goto help