Fix docs build to run properly

Change-Id: I7f684bc48c5ce913a5799f78c80bda459cf35f65

CONTRIBUTING.rst

@@ -14,4 +14,4 @@ Pull requests submitted through GitHub will be ignored.
 
 Bugs should be filed on Launchpad, not GitHub:
 
-   https://bugs.launchpad.net/oslo.serialization
+   https://bugs.launchpad.net/oslo

doc/source/contributing.rst

@@ -1 +1,5 @@
-.. include:: ../../CONTRIBUTING.rst
+==============
+ Contributing
+==============
+
+.. include:: ../../CONTRIBUTING.rst

doc/source/readme.rst

@@ -1 +1 @@
-.. include:: ../README.rst
+.. include:: ../../README.rst

setup.cfg

@@ -26,6 +26,9 @@ packages =
 namespace_packages =
     oslo
 
+[pbr]
+warnerrors = true
+
 [build_sphinx]
 source-dir = doc/source
 build-dir = doc/build
@@ -46,4 +49,4 @@ input_file = oslo.serialization/locale/oslo.serialization.pot
 [extract_messages]
 keywords = _ gettext ngettext l_ lazy_gettext
 mapping_file = babel.cfg
-output_file = oslo.serialization/locale/oslo.serialization.pot
+output_file = oslo.serialization/locale/oslo.serialization.pot

test-requirements.txt

@@ -1,7 +1,11 @@
 hacking>=0.5.6,<0.8
 mock>=1.0
 netaddr
+
+# this is required for the docs build jobs
+sphinx>=1.1.2,!=1.2.0,<1.3
 oslosphinx
+
 oslotest
 simplejson
 oslo.i18n>=0.2.0

tox.ini

@@ -22,6 +22,9 @@ commands = flake8
 [testenv:venv]
 commands = {posargs}
 
+[testenv:docs]
+commands = python setup.py build_sphinx
+
 [testenv:cover]
 commands = python setup.py testr --coverage --testr-args='{posargs}'
 
@@ -32,4 +35,4 @@ commands = python setup.py testr --coverage --testr-args='{posargs}'
 show-source = True
 ignore = E123,E125,H803
 builtins = _
-exclude=.venv,.git,.tox,dist,doc,*openstack/common*,*lib/python*,*egg,build
+exclude=.venv,.git,.tox,dist,doc,*openstack/common*,*lib/python*,*egg,build