Switch to openstackdocstheme 2.2.1 version. Using
this version 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: If046b8dded45c939bf596fdc8ae95f0d34602054
Make a few cleanups:
- Remove obsolete sections from setup.cfg
- Switch to using sphinx-build
- Cleanup doc/source/conf.py to remove now obsolete content.
- Switch to openstackdocstheme version
- Remove install_command from tox.ini, the default is fine
- Fix docs warnings
Change-Id: Icf6a2d4229392e9d38af67567167b60d02d68019
Fix the Sphinx html_last_updated_fmt for Python3. The
html_last_updated_fmt option is interpeted as a byte string in
python3, causing Sphinx build to break. This patch makes it
utf-8 string.
Change-Id: I399b769c3d636e40094837764da6a914132a779c
The idea of policies is to document something related to the project
that isn't tied to a specific release and often isn't related to code.
For example, a policy could be related to how we organise or how we
agree to do code reviews.
This process is inspired by the policies used in TripleO and the policy
template is a direct copy of the one used in TripleO.
Change-Id: I05f5076a1559790bf6d0f7b68d528748a2acd20b
When building packages if git is absent, then we should not set
html_last_updated_fmt. It can still be set via the -D switch
when building with sphinx-build.
Change-Id: I7b8e5e23bc9dc439bc29fcf791fc44d0c82cb8ab
Closes-Bug: #1552251
os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.
Change-Id: I24714535b3745b21657c97c7acc00a92dbc2cfda
Closes-Bug: #1529836
Add structure, unit tests, and template for mistral-specs, creating
a functional specs repository without any approved specs.
Put example.rst in mitaka/approved and mitaka/implemented respectively
to avoid doc build warnings:
"pattern u'specs/mitaka/approved/*' didn't match any documents"
Implements: blueprint mistral-spec-repository
Change-Id: I092ec2f9b1aef9b1bf328658674119eb3cdf3380