Bring doc build up to standard

Move the requirements definitions and documentation files to the
standard places used by other OpenStack projects so our doc publishing
jobs will work.

Change-Id: Iea630d827976fe517afacf4e373b3a125efff9c9

doc/source/conf.py

@@ -31,6 +31,7 @@ extensions = [
     'sphinx.ext.todo',
     'sphinx.ext.graphviz',
     'sphinx.ext.extlinks',
+    'oslosphinx',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -99,7 +100,7 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+#html_theme = 'default'
 
 # 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
@@ -128,7 +129,7 @@ html_theme = 'default'
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+#html_static_path = ['_static']
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.

setup.cfg

@@ -40,8 +40,8 @@ stevedore.test.extension =
 
 [build_sphinx]
 all_files = 1
-build-dir = docs/build
+build-dir = doc/build
-source-dir = docs/source
+source-dir = doc/source
 
 [wheel]
 universal = true

test-requirements.txt

@@ -9,3 +9,4 @@ coverage>=3.6
 testrepository>=0.0.18
 discover
 oslotest>=1.2.0  # Apache-2.0
+oslosphinx>=2.2.0  # Apache-2.0