Cleanup docs building

a few cleanups:
- Remove obsolete sections from setup.cfg
- Switch to using sphinx-build
- Remove install_command from tox.ini, the default is fine
- Update pbr requirements
- Fix problems, mainly "Could not lex literal block"
- Use py38 job for Victoria cycle

Change-Id: Id706786bed4b20682704d524986850b7c71e225d
This commit is contained in:
Andreas Jaeger 2020-06-04 09:35:01 +02:00
parent 9704c344c1
commit f26534191e
9 changed files with 12 additions and 24 deletions

View File

@ -3,7 +3,7 @@
- openstack-specs-jobs
check:
jobs:
- openstack-tox-py37
- openstack-tox-py38
gate:
jobs:
- openstack-tox-py37
- openstack-tox-py38

View File

@ -1,4 +1,4 @@
pbr>=0.6,<1.0
pbr!=2.1.0,>=2.0.0 # Apache-2.0
openstackdocstheme>=2.2.1 # Apache-2.0
sphinx>=2.0.0,!=2.1.0 # BSD
yasfb>=0.8.0

View File

@ -11,14 +11,3 @@ classifier =
Intended Audience :: Developers
License :: OSI Approved :: Apache Software License
Operating System :: POSIX :: Linux
[build_sphinx]
source-dir = doc/source
build-dir = doc/build
all_files = 1
[pbr]
warnerrors = True
[upload_sphinx]
upload-dir = doc/build/html

View File

@ -275,7 +275,7 @@ For example, given the :ref:`Puppet <capabilities-ex-puppet>` and
Which would return:
.. code-block:: json
.. code-block::
{
'deployment': ['puppet', 'docker']
@ -284,7 +284,7 @@ Which would return:
A similar version of the call exists if the
:ref:`capabilities-annotation-type` annotation is used:
.. code-block:: json
.. code-block::
{
'OS::TripleO::Controller': ['puppet/controller.yaml',

View File

@ -24,7 +24,7 @@ or even from ceilometer, the signaling request may have a predefined body,
which is not compatible with the json format expected by the workflow resource.
The os::mistral::workflow expects the body to be in this format:
.. code-block:: json
.. code-block::
{
"input":{
@ -37,7 +37,7 @@ The os::mistral::workflow expects the body to be in this format:
however, ceilometer, for example, sends this body in the request:
.. code-block:: json
.. code-block::
{
"severity": "low",

View File

@ -119,7 +119,7 @@ template:
We will add a default policy rule for this resource to be limited to
administrators.
.. code-block:: json
.. code-block::
"resource_types:OS::Cinder::Quota": "rule:project_admin"

View File

@ -165,7 +165,7 @@ template:
A default policy rule will be added for this resource to be limited to
administrators.
.. code-block:: json
.. code-block::
"resource_types:OS::Neutron::Quota": "rule:project_admin"

View File

@ -179,7 +179,7 @@ updated. Otherwise, the project's quota will be updated.
A default policy rule will be added for this resource to be limited to
administrators.
.. code-block:: json
.. code-block::
"resource_types:OS::Nova::Quota": "rule:project_admin"

View File

@ -6,7 +6,6 @@ skipsdist = True
[testenv]
basepython = python3
usedevelop = True
install_command = pip install -U {opts} {packages}
setenv =
VIRTUAL_ENV={envdir}
deps = -r{toxinidir}/requirements.txt
@ -20,7 +19,7 @@ commands =
commands = {posargs}
[testenv:docs]
commands = python setup.py build_sphinx
commands = sphinx-build -W -a -b html doc/source doc/build/html
[testenv:spelling]
deps =