Update Sphinx version and switch to openstackdocstheme

Update sphinx version as in global requirement
Global requirement link [1]

Also This patch switches to use openstackdocstheme instead of
oslosphinx[2].

[1] 23ff2adcec/global-requirements.txt (L455)
[2] https://docs.openstack.org/openstackdocstheme/latest/#using-the-theme

Change-Id: I024faa5728b79eeb91c3bb8592a0474bc7900005

doc/source/conf.py

@@ -29,7 +29,7 @@ import os
 extensions = ['sphinx.ext.autodoc',
               'sphinx.ext.todo',
               'sphinx.ext.viewcode',
-              'oslosphinx'
+              'openstackdocstheme'
              ]
 
 todo_include_todos = True
@@ -91,7 +91,7 @@ man_pages = []
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'nature'
+html_theme = 'openstackdocs'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -265,3 +265,9 @@ epub_copyright = u'2014, Congress Contributors'
 
 # Allow duplicate toc entries.
 #epub_tocdup = True
+
+# -- Options for openstackdocstheme ---------------------------------------
+
+repository_name = 'openstack/congress-specs'
+bug_project = 'congress-specs'
+bug_tag = ''

requirements.txt

@@ -1,5 +1,6 @@
-oslosphinx
+openstackdocstheme>=1.18.1 # Apache-2.0
 pbr>=0.6,!=0.7,<1.0
-sphinx>=1.1.2,!=1.2.0,<1.3
+sphinx!=1.6.6,!=1.6.7,>=1.6.2,<2.0.0;python_version=='2.7' # BSD
+sphinx!=1.6.6,!=1.6.7,>=1.6.2;python_version>='3.4' # BSD
 stestr>=2.0.0
 testtools>=0.9.34

specs/stein/json-data-model.rst

@@ -252,7 +252,7 @@ Example 1
   - Congress-CloudState equivalent:
     ::
 
-     CREATE SCHEMA vm_host_down; 
+     CREATE SCHEMA vm_host_down;
 
 - Create policy rule (view) identifying those servers whose host is down.