make tox docs environment follow PTI guidelines for sphinx build

https://governance.openstack.org/tc/reference/project-testing-interface.html#documentation
says:

    Note:

    We strongly discourage project teams from adding commands to the
    docs environment beyond:

        sphinx-build -W -b html doc/source doc/build/html

Discussion on #openstack-doc prompted the suggestion to adjust the
cookiecutter templates accordingly:

http://eavesdrop.openstack.org/irclogs/%23openstack-doc/%23openstack-doc.2018-08-09.log.html#t2018-08-09T16:04:54

Also update requirements.txt.

Change-Id: I8f23c82405692e9984ed1089fa44ac25cbc27aeb
This commit is contained in:
Adam Spiers 2018-08-09 18:11:41 +01:00
parent 219a12ae70
commit 61a80f07ac
2 changed files with 2 additions and 2 deletions

View File

@ -7,4 +7,4 @@ oslotest>=1.5.1
# These are needed for docs generation
oslosphinx>=2.5.0
sphinx!=1.2.0,!=1.3b1,<1.3,>=1.1.2
sphinx!=1.6.6,!=1.6.7,>=1.6.2 # BSD

View File

@ -38,7 +38,7 @@ install_command = {[testenv:common-constraints]install_command}
commands = python setup.py test --coverage --testr-args='{posargs}'
[testenv:docs]
commands = python setup.py build_sphinx
commands = sphinx-build -W -b html doc/source doc/build/html
[testenv:docs-constraints]
install_command = {[testenv:common-constraints]install_command}