Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* parallelizing building of documents
Update Sphinx version as well.
openstackdocstheme renames some variables, so follow the renames. A
couple of variables are also not needed anymore, remove them.
Set openstackdocs_auto_name to use project as name.
Set openstackdocs_pdf_link to link to PDF file.
Remove docs requirements from lower-constraints, they are not installed.
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.
See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html
Change-Id: I320a69816b4101bb76b88448881f3177c892ea92
Some options are now automatically configured by the version 1.20:
- project
- html_last_updated_fmt
- latex_engine
- latex_elements
- version
- release.
Change-Id: Icca6ef602af26a1d10766fd416011cdcceaa00a1
- Fix minor grammatical issues
- Include the `strict_two_level` model in the enforcement model
section
- Improve readability
- Add enforcement examples in the form of diagrams
Change-Id: I483bf172dfe01f1db5a9673192eac988267996da
The code to generate a support matrix has been pulled into a common
library. Using this instead of duplicating code in various projects that
need it.
Change-Id: Ib15c086ceb84029e96be0fc60bd64f2a7a3e41aa
Co-Authored-By: Stephen Finucane <stephenfin@redhat.com>
Add an introduction to the federation documentation discussing
background information on identity federation and how it is implemented
in keystone.
This repurposes some of the content in this blog post[1] of which I am
the author.
[1] http://www.gazlene.net/demystifying-keystone-federation.html
Partial-bug: #1793374
Change-Id: I5f3a5e70c7b868762880930ea6277691f44c046a
A recent change defaults the warning-as-error to True:
https://review.openstack.org/#/c/559348/
Which is causing our documentation jobs to fail locally and in the
gate/check queues.
This commit fixes both issues that are causing failures so that
we can get the doc jobs passing again.
Closes-Bug: 1774508
Change-Id: Ic1eff48a6f40aa315cc5e566a0f9e930a20b9837