Commit Graph

9 Commits

Author SHA1 Message Date
Andreas Jaeger befadaa1b0 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: I30bdb1bf76a12e9562ab461b2701a36f34e770fe
2020-06-03 21:01:11 +02:00
Andreas Jaeger 28cce354d9 Cleanup py27 support
This repo is now testing only with Python 3, so let's make
a few cleanups:
- Remove obsolete sections from setup.cfg
- Update requirements, no need for python_version anymore
- Use newer openstackdocstheme version, update other requirements

Change-Id: I2aec09250c96bc411d19cb6c1a1ee852394d39e5
2020-04-11 14:37:38 +02:00
Dmitry Tantsur 3abffb4fd7 Use doc8 to verify rst instead of custom tests
Fix a disproportionally long line in dns-sd.

Change-Id: I9137ce1780e971824bffdd4e6557ddeb44c4db0b
2020-03-19 11:43:16 +01:00
Dmitry Tantsur 19c3c6f566 Update Sphinx requirements and actually use Python 3 for docs
This fixes building the guidelines (again) since Sphinx 2.0.0 is not
compatible with Python 2.7, and the way we use basepython in tox.ini
is not correct (resulting in Python 2 being used by default).

Change-Id: Ieeeb319caa6d7a8dad78857c7dce105da33d2dd2
2019-05-17 09:48:18 +02:00
Dmitry Tantsur 2ef2b12a82 Repair building guidelines
The recent yasfb is not compatible with ancient sphinx, just bump
both requirements, as well as replace deprecated oslosphinx with
openstackdocstheme (requirements shamelessly copied from ironic-specs).
While we're here, uncap pbr and bump it to 1.0.

Change-Id: Ia78499827a53f5ee0c7a8b0d9951a0e37dedc91b
2019-04-09 15:55:33 +00:00
Vu Cong Tuan bfcbef7e9c Switch to stestr
According to Openstack summit session [1],
stestr is maintained project to which all Openstack projects should migrate.
Let's switch to stestr as other projects have already moved to it.

[1] https://etherpad.openstack.org/p/YVR-python-pti

Change-Id: Iddce63084a10cbc5b1670f42acae6c2ee96e0ce8
2018-07-10 18:40:22 +07:00
Andreas Jaeger edff818d30 Add RSS feed
Setup yasfb to generate an RSS feed for approved specs. This is a change
that is done for all published documents on specs.openstack.org.

Update requirements with current global requirements.

Change-Id: I7a72413ab2f7621b4614d3a9b311796b5d76bd07
2014-12-12 09:22:02 +01:00
Steve Martinelli a46953e765 Clean up comments from initial code drop
There were a few comments from the initial code drop from:
https://review.openstack.org/#/c/130120/1

Change-Id: I48e8be72f0d6245a57830ce14eed99df3c1ae65c
2014-10-22 16:16:12 -04:00
Chris Yeoh e00144c3a0 Moves from markdown to rst
Changes format of files from markdown to reStructuredText
and adds the tox targets to verify the format and build
the html. Also adds bits and pieces needed to finish
bootstrapping the repository.

Change-Id: If559c21f19d7044a0d89b29e5743bf09c9da2ac1
2014-10-22 16:24:41 +10:30