Update docs job

publish-openstack-sphinx-docs jobs are obsolete since some time,
use the newer publish-openstack-docs-pti jobs instead.

Update tox.ini to use the PTI way of building docs.

Fix all RST errors found so that this builds cleanly now.

Change-Id: I61dd9c0a2caa1b2e0c5e71c609091b7bb356520a
This commit is contained in:
Andreas Jaeger 2019-05-19 13:33:53 +02:00
parent 8fd845a7c7
commit ccdcae52be
16 changed files with 27 additions and 24 deletions

View File

@ -1,3 +1,3 @@
- project:
templates:
- publish-openstack-sphinx-docs
- publish-openstack-docs-pti

View File

@ -1,4 +1,4 @@
.. _release_notes_17.02
.. _release_notes_17.02:
=====
17.02

View File

@ -1,4 +1,4 @@
.. _release_notes_17.08
.. _release_notes_17.08:
=====
17.08

View File

@ -1,4 +1,4 @@
.. _release_notes_17.11
.. _release_notes_17.11:
=====
17.11

View File

@ -1,4 +1,4 @@
.. _release_notes_1802
.. _release_notes_1802:
=====
18.02

View File

@ -1,4 +1,4 @@
.. _release_notes_1805
.. _release_notes_1805:
=====
18.05

View File

@ -1,4 +1,4 @@
.. _release_notes_18.08
.. _release_notes_18.08:
=====
18.08
@ -204,7 +204,8 @@ https://bugs.launchpad.net/glance/+bug/1789748
The workaround is to manually set the read ACL on the glance container
.. code:: bash
swift post glance --read-acl ".r:*,.rlistings"
swift post glance --read-acl ".r:*,.rlistings"
Two, the glance-simplestreams-sync charm relies on simplestreams which is not yet glance v2 aware:

View File

@ -1,4 +1,4 @@
.. _release_notes_18.11
.. _release_notes_18.11:
=====
18.11
@ -193,7 +193,10 @@ One, when using swift store as a back end for glance, glance fails to set the AC
https://bugs.launchpad.net/glance/+bug/1789748
The workaround is to manually set the read ACL on the glance container
swift post glance --read-acl ".r:*,.rlistings"
.. code:: bash
swift post glance --read-acl ".r:*,.rlistings"
Two, the glance-simplestreams-sync charm relies on simplestreams which is not yet glance v2 aware:
https://bugs.launchpad.net/simplestreams/+bug/1790904

View File

@ -1,4 +1,4 @@
.. _release_notes_19.04
.. _release_notes_19.04:
=====
19.04
@ -87,7 +87,7 @@ New Charm Features
==================
With each new feature, there is a corresponding example bundle in the form of
a test bundle, and/or a `charm deployment guide <https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/>`_
a test bundle, and/or a `charm deployment guide <https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/>`__
section which details the use of the feature. For example test bundles, see the
src/tests/bundles/ directory within the relevant charm repository.

View File

@ -23,7 +23,7 @@ layers.yaml
~~~~~~~~~~~
The **src/layers.yaml** file defines what layers and interfaces will be imported
and included in the charm when the charm is built. See the `OpenStack Layers`_
and included in the charm when the charm is built. See the `Openstack Layers`_
section and `OpenStack Interfaces`_ section below. If additional interfaces or
layers add them to the **includes** list within **src/layers.yaml**.
@ -60,8 +60,6 @@ describes the charm and how it relates to other charms. This is also
constructed from each layer that defines a metadata.yaml
.. _`OpenStack Layers`:
OpenStack Layers
----------------
@ -74,8 +72,6 @@ Juju hooks and runs the charms.reactive.main loop for them. It also bootstraps
the charm-helpers and charms.reactive libraries and all of their dependencies
for use by the charm.
.. _`OpenStack Layer`:
OpenStack Layer
~~~~~~~~~~~~~~~

View File

@ -1 +0,0 @@
release-policy.rst

View File

@ -68,7 +68,10 @@ copyright = Markup(u'%s, OpenStack Contributors '
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
exclude_patterns = ['_build']
exclude_patterns = [
'_build',
'release-notes-template.rst'
]
# The reST default role (used for this markup: `text`) to use for all documents.
#default_role = None

View File

@ -41,7 +41,7 @@ During the charm generation charm tools asks a few questions about the charm.
What is the earliest OpenStack release this charm is compatible with? liberty
What packages should this charm install (space separated list)?
.. _`Build Charm`:
.. _`build_sdn_charm`:
Build Charm
===========
@ -104,7 +104,7 @@ setting in nova.conf.
})
This tells the charm to send that configuration to the principle where the
**neutron-plugin.connected** event has been raised. Then repeat the `Build Charm`_
**neutron-plugin.connected** event has been raised. Then repeat the `build_sdn_charm`_
steps.
Deploy Update

View File

@ -1,4 +1,4 @@
.. _release_notes_<CHARM_RELEASE>
.. _release_notes_<CHARM_RELEASE>:
**** This is a template file for future release notes and its contents should not be linked or referenced. Use actual release notes instead. ****

View File

@ -1 +0,0 @@
release-notes.rst

View File

@ -15,4 +15,6 @@ deps = -r{toxinidir}/requirements.txt
commands = {posargs}
[testenv:docs]
commands = python setup.py build_sphinx
commands = sphinx-build -W -d doc/build/doctrees -b html doc/source/ doc/build/html