Do not give sphinx-build as single argument, split it up.
tox 2.5.0 currently complains that it cannot find "sphinx-build arg1
arg2" - so, pass this properly now.
Add releasenote for this.
Change-Id: I5da1d06866c16a8c56be23e87817d163b28803a8
Releasenote translation publishing is being prepared. 'locale_dirs'
needs to be defined in conf.py to generate translated version of the
release notes.
Note that this repository might not get translated release notes - or
no translations at all - but we add the entry here nevertheless to
prepare for it.
Change-Id: Iace1593dff20324b86c7245c2217d51d77d9a465
This is needed for publishing in the future:
This is so that we can create a list of directories to ignore when we
rsync documentation builds to a publishing site. Some builds are
published as subdirectories underneath the results of superior
builds.
This allows those superior builds to be rsynced without removing the
other builds that were published under them.
http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html
Change-Id: Ic8773caebecafa87b10c1ad4612bde6b1513b667
openstack-doc-test is used for building of DocBook XML files. For index
page generation openstack-indexpage can be used.
Remove openstack-doc-test together with all support files.
Change-Id: I5589bc634e1f630f79b3d6e8bffee939c5300bf2
To migrate CLI Reference from DockBook to RST,
output the documentation in RST format,
with a few work around for RST/Sphinx specific issue.
Change-Id: I32b4cfefa978436061d882f7520bbc92c1645b4e
Implements: blueprint cli-ref-rst
We want to be able to change the section in which an option is
registered in the documentation. This patch uses a <project>.overrides
file to define in which section(s) an option should be moved.
The format of this file is (1 line per option):
[<group>/]<option> <new_group1>[ <new_group2> ... ]
Change-Id: I9fd0b763b6e56cd360694566de7f3acc3172c9c1
Closes-Bug: #1522794
Split up draft guides under separate heading and remove draft word for
easier review.
The output looks now basically like:
Generated documents
admin-guide-cloud
contributor-guide
networking-guide
user-guide
user-guide-admin
Draft Guides
arch-design-rst
config-ref-rst
image-guide-rst
install-guide-debian
install-guide-obs
install-guide-rdo
install-guide-ubuntu
Also, create separate tool openstack-indexpage that only generates index
page.
Change-Id: Ic68a674918f18dc37f8b9fa4e9d9f529a8ad131e
The extract_swift_flags.py script parses the existing docbook tables to
discover documented options. We're now switching to RST so implement
reading from RST tables, and make it the default behaviour.
Implements: blueprint config-ref-rst
Change-Id: Ib7a14cc52337fc1abd8b02a8ff33396c0b992746
Mark RELEASE_NOTES.rst as obsolete and give pointer for new work flow.
Move one entry from current RELEASE_NOTES to reno.
Change-Id: I94d81e00d0a4405c1dfce9fdb83a2ec6f26eae5a
As suggested by Doug Hellmann, properly define the release-notes to
automatically generate content.
Change-Id: I4c2f9086d40ef428239943240f61c74cf16e1ab6
