Commit Graph

4 Commits

Author SHA1 Message Date
Andreas Jaeger 188a3338f7 Cleanup docs building
This repo is now testing only with Python 3, so let's make
a few cleanups:
- Remove obsolete sections from setup.cfg
- Switch to using sphinx-build
- Remove install_command from tox.ini, the default is fine
- cleanup tox.ini
- Update pbr requirement

Change-Id: I0adc74190fa820434a46b2a6bf9247ca6eb3e51d
2020-06-04 09:42:05 +02:00
Andreas Jaeger eb7c979999 Switch to newer openstackdocstheme version
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: I9dbba04f3918ced819e9e69a58bc5e580ad5d538
2020-05-31 17:50:01 +02:00
Bharat Kunwar d2b6c23959 ci: Fix and address all tox -e docs warnings
Warning is now treated as an error to prevent backlog of genuine
formatting issues, e.g. improper references, indentation and not listing
newly added specs into the index.

Change-Id: I3b8a1ce7f931bfd83db36600dc74d1d0c2ef293e
2020-04-02 11:13:31 +00:00
Spyros Trigazis 74da0acf5d Initial commit
Spec repo created using the specs-cookiecutter repo [1].

[1] https://git.openstack.org/cgit/openstack-dev/specs-cookiecutter

Change-Id: Id6ed56d21ff0984ea7394e21b204a99cd2237956
2016-11-09 16:34:29 +01:00