Update sphinx library and treat warnings as errors

This commit updates sphinx library and treats warnings as errors. We
often miss doc warnings. So this commit makes them errors to build a
better html document.

Change-Id: I86fc23761ec24b0fdaae234cf37737dbc1bddd29
This commit is contained in:
Masayuki Igawa 2017-06-21 16:49:35 +09:00 committed by Andreas Jaeger
parent cbe3384685
commit 31acf1316f
13 changed files with 49 additions and 10 deletions

View File

@ -303,3 +303,6 @@ epub_copyright = u'2014, OpenStack QA Team'
# Allow duplicate toc entries.
#epub_tocdup = True
# Do not warn about non-local image URI
suppress_warnings = ['image.nonlocal_uri']

View File

@ -15,6 +15,7 @@ classifier =
all_files = 1
build-dir = doc/build
source-dir = doc/source
warning-is-error = 1
[pbr]
warnerrors = True

View File

@ -0,0 +1,12 @@
..
This work is licensed under a Creative Commons Attribution 3.0 Unported
License.
http://creativecommons.org/licenses/by/3.0/legalcode
===========
Placeholder
===========
This is just a placeholder file to avoid sphinx errors. Please remove this
file when you add a new rst file.

View File

@ -0,0 +1,12 @@
..
This work is licensed under a Creative Commons Attribution 3.0 Unported
License.
http://creativecommons.org/licenses/by/3.0/legalcode
===========
Placeholder
===========
This is just a placeholder file to avoid sphinx errors. Please remove this
file when you add a new rst file.

View File

@ -91,7 +91,6 @@ List the qa projects that this spec effects. For example:
Implementation
==============
Assignee(s)
-----------
Primary assignees:
david-purcell [david.purcell@att.com]

View File

@ -0,0 +1,12 @@
..
This work is licensed under a Creative Commons Attribution 3.0 Unported
License.
http://creativecommons.org/licenses/by/3.0/legalcode
===========
Placeholder
===========
This is just a placeholder file to avoid sphinx errors. Please remove this
file when you add a new rst file.

View File

@ -11,9 +11,9 @@ Tempest support for API microversions testing
https://blueprints.launchpad.net/tempest/+spec/api-microversions-testing-support
Since Kilo, nova has implemented API microversions and the other components (Ironic, etc)
also implemented it now. However, currently Tempest does not have any support for microversions
and doesn't test it at all.
Since Kilo, nova has implemented API microversions and the other components
(Ironic, etc) also implemented it now. However, currently Tempest does not
have any support for microversions and doesn't test it at all.
This proposal is to add microversions testing support in Tempest.
Problem description
@ -81,7 +81,7 @@ Test classes for each microversion
TestClass D: min_microversion = '2.5', max_microversion = '2.10'
+--------------------+-----------------------------------------------------+
| Configuration | Test classes |
| Configuration | Test classes |
| (min, max) | (Passed microversion) |
+====================+=====================================================+
| None, None | A(Not passed), B(Not passed), C & D - Skipped |

View File

@ -134,8 +134,8 @@ Target Milestone for completion:
Work Items
----------
* Take ownership of tempest on pypi [1]
* Enable publishing tempest to pypi [2]
* Take ownership of tempest on pypi [1]_
* Enable publishing tempest to pypi [2]_
* Add reno release notes to both tempest and tempest-lib
* Iterate through reintegration:
* Move all the code from tempest-lib to tempest.lib in the tempest repo

View File

@ -54,7 +54,7 @@ this workflow with python-novaclient CLI tests:
#. Add CLI base test classes with core functionality to the new library
#. Switch the tempest CLI tests to use the library instead
#. Remove code in tempest which has been switched to the library
#. Add a functional test suite to the novaclient repository and copy the
#. Add a functional test suite to the novaclient repository and copy the
appropriate CLI tests from tempest
#. Remove the copied novaclient CLI tests from tempest
@ -154,4 +154,4 @@ library conversion.
References
==========
.. [1] http://lists.openstack.org/pipermail/openstack-dev/2014-March/028920.html
- http://lists.openstack.org/pipermail/openstack-dev/2014-March/028920.html

View File

@ -15,7 +15,7 @@ commands = {posargs}
[testenv:docs]
basepython = python3
commands = python setup.py build_sphinx
commands = sphinx-build -W -b html doc/source doc/build/html
[testenv:spelling]
deps =