Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems
Update Sphinx version as well.
Disable openstackdocs_auto_name to use 'project' variable as name.
Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.
openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.
See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html
Change-Id: Iac415cd5bd7346847edeb174b059ffbc3e2a1bdf
Make a few cleanups:
- Remove obsolete sections from setup.cfg
- Remove install_command from tox.ini, the default
is fine
- Switch to sphinx-build
- Enable warnings for doc build, fix all warnings
- Remove git handling from conf.py, openstackdocstheme does this now
- Cleanup tox.ini
Change-Id: I51796be20596afc2305c2d8ea189b4037bd28b2d
The docs target in tox was failing because it was still using
oslosphinx. This patch replaces it with openstackdocstheme.
Change-Id: I4b6a93a306441f25d333889eaab3e9bbab3974c6
Story: 2005767
Task: 33481
This is a mechanically generated patch to complete step 1 of moving
the zuul job settings out of project-config and into each project
repository.
Because there will be a separate patch on each branch, the branch
specifiers for branch-specific jobs have been removed.
Because this patch is generated by a script, there may be some
cosmetic changes to the layout of the YAML file(s) as the contents are
normalized.
See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html
Remove stein from toc, there's no spec yet and zuul complains about an
empty toc.
Change-Id: Iede70fc477d0fe7b0b63336d1e120d5d5c23160d
Story: #2002586
Task: #24285
- Listed out detail work items in the specification document.
- Listed out detail primary assignee.
- Added assert "assert:supports-rolling-upgrade" tag for Barbican
Change-Id: If758e84b6aa9a86de46ce405d8e174ca56c76723
The current order of the projects has oldest release listed first.
Reversing this order to minimize scrolling in the UI.
Change-Id: Ibe87c7ade02df49146ce68a1d36f6806b43cf783
OpenStack has dropped the incubation notion, so labeling this as an
incubated project in the docs is confusing.
Change-Id: I5208ceebba4ce388039a7697fda8b5794db920c2
Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)
This also removes the requirement for internet access during docs build.
This can cause docs jobs to fail if the project errors out on
warnings.
Change-Id: I71e941e2a639641a662a163c682eb86d51de42fb
Related-Bug: #1368910
We don't want the templates to show up in the RSS feed, so exclude them
from being converted to HTML and listed in the toctree.
Change-Id: I67496730d1952ffdec92c5f78531508c55225ca6
Update the theme used in the barbican-specs documentation to the
latest from oslosphinx. This will help create a more common look
and feel throughout specs.openstack.org.
Change-Id: I29157520915b0952ec650dcfc389667ceaf9b88a