Re-enable "Page Contents" and update user docs

This patch re-enables the page Table of Contents (ToC) for the Octavia
documentation. Previously the theme had the table of contents at the top
of each page which cluttered our index pages. Now the theme based ToC is
located on the left navigation menu.

This patch also reorganizes the user documentation section and adds a link
to our "Introduction to OpenStack Load Balancing" presentation from the
2017 Boston summit.

This change will not impact bookmarks.

Change-Id: Ib200f8b95e216b081d884da017fa1cce85f48763

doc/source/conf.py

@@ -331,10 +331,6 @@ epub_copyright = u'2014, OpenStack Octavia Team'
 policy_generator_config_file = '../../etc/policy/octavia-policy-generator.conf'
 sample_policy_basename = 'configuration/_static/octavia'
 
-# openstackdocstheme options
-html_theme_options = {
-    'display_toc': False
-}
 repository_name = 'openstack/octavia'
 bug_project = '908'
 bug_tag = 'docs'

doc/source/user/index.rst

@@ -2,15 +2,42 @@
 Octavia User
 ============
 
+Cookbooks
+=========
 .. toctree::
    :glob:
    :maxdepth: 1
 
+   guides/basic-cookbook
+   guides/l7-cookbook
+   guides/basic-cookbook-neutron
+   guides/l7-cookbook-neutron
+
+Guides
+======
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   guides/l7
+
+References
+==========
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   Octavia API Reference <https://developer.openstack.org/api-ref/load-balancer/>
    Command Line Interface Reference <https://docs.openstack.org/python-octaviaclient/latest/cli/index.html>
+   sdks
 
-   guides/*
+Videos
+======
+.. toctree::
+   :glob:
+   :maxdepth: 1
 
-   sdks.rst
+   Introduction to OpenStack Load Balancing (2017 Boston Summit) <https://youtu.be/BBgP3_qhJ00>
 
 Indices and Search
 ------------------