This is a mechanically generated patch to complete step 1 of moving
the zuul job settings out of project-config and into each project
repository.
Because there will be a separate patch on each branch, the branch
specifiers for branch-specific jobs have been removed.
See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html
Change-Id: I24a04c9c63423d79504d79978638b8e403db098c
Story: #2003250
build-openstack-sphinx-docs jobs fail on stable branches due to the new
pip version 10 introduces some previously Warning as Error: in case of
calling "pip install" without any package name, the command fails.
tox_install.sh is called during docs job without any package passed to pip.
Change-Id: I391c779e4692d5de526dfda035843b8f5e267a75
As part of the docs migration work[0] for Pike we need to switch to use
the openstackdocstheme.
[0]https://review.openstack.org/#/c/472275/
Change-Id: Ib35eb111e766b244d03eb9b52badb54d08efb07b
This change removes the now unused "warnerrors" setting,
which is replaced by "warning-is-error" in sphinx
releases >= 1.5 [1].
[1] http://lists.openstack.org/pipermail/openstack-dev/
2017-March/113085.html
Change-Id: I59291198f7a216df2f5e5beb2915f48e5a26bd89
the rename to neutronclient has been some time ago already. Also
the link was pointing to swift instead, which seems like an obvious
copy&paste mistake.
Change-Id: I2596e7500dedd01caa624377633754bf4a56fb48
When subprocess is monkey-patched using eventlet, trying to catch
subprocess.CalledProcessError exception won't work [1]. This breaks
doc build from a tarball, so let's catch all exceptions.
[1] https://github.com/eventlet/eventlet/issues/357
Change-Id: Ibcf535c6e4994a67fc3ec71631a81ecb91dd2845
Closes-Bug: #1693148
Since pbr already landed and the old version of hacking seems not
work very well with pbr>=2, we should update it to match global
requirement.
Partial-Bug: #1668848
Change-Id: I6b487922bde32b233eaffbcf76a94144bec06837
Amended developer documentation side navigation to add an option for
clearly returning to the project developer documentation home page.
Previously it was possible to return to the home page by clicking
'table of contents' however this is not obvious and makes it hard
to get around the complete project documentation once you have left
the homepage.
This patch removes the link from 'table of contents' which is
misleading, and a link is added beneath this header to say 'Return
to project home page'.
Change-Id: I7cf96acead62f00224ca9217a80760b4a65d42d6
Closes-bug: #1666323
Based on the branding guidelines linked in this patch, projects that are
not officially under governance should not use the theme in most
circumstances.
Change-Id: Id6ded25a20965803ddbca0c2e587d3f4c476168f
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
Now that there exists only a gate job for Python 3.5 and not 3.4,
we should remove those references to the 3.4 that is untested.
Change-Id: I5ca7599f52f2f091c15decce324799a5502ed144
Adding constraints support to libraries is slightly more complex than
services as the libraries themselves are listed in upper-constraints.txt
which leads to errors that you can't install a specific version and a
constrained version.
This change adds constraints support by also adding a helper script to
edit the constraints to remove oslosphinx.
Change-Id: I3daafcf22e2d9a1cd73d389debe3b27eccc91910
The release management team have indicated this is their preferred way
to collect release notes in future.
Closes-Bug: #1634356
Change-Id: I1b07a37eaa57c0f1767a534c6208d62d572a80a4
Sphinx supports various notice blocks but the oslosphinx theme
does support only warning and note. openstackdoctheme used by
openstack-manuals project supports 'important', 'tip' and 'caution'
blocks. It would be nice if oslosphinx support these notices.
It reduces confusions on contributors to both types of projects.
Change-Id: I3e1db551b05fa681520763c24e2576f9ad5379d8
When git cmd fails, raw_version_list is set to empty 'str' and then
we are trying to decode it. This patch moves decoding inside try/catch
block, so we are decoding return value of subprocess call, which is bytes
in Python 3.
Change-Id: Ibd2f556355a6413beb21473ebfca3b836cbc1d73
Adds a new option that allows the "Other Versions" section to be removed
if a project isn't interested in showing links to older versions. The
default value is False which means that it will be hidden.
Even though the setting is not backward compatible there are enough
broken documentation links in the OpenStack projects that this should be
opt-in behavior.
Change-Id: Ic4b47b19aa9db38557c37aed7722174b7dbdf4a1
Closes-Bug: #1599260
Make the first one link to the current docs and the others
link with the appropriate prefix.
Filtered out previous versions that include "rc".
The number of versions is kept at 5 (current + 4 recent).
Closes-Bug: #1589731
Change-Id: I3a2e219913fc2c89634bcc2a757ccb4d3510883a
When later used the current code will break in
python3 due to:
TypeError: 'str' does not support the buffer
interface
Change-Id: I11572dd510ce8255ed66de56d5d9000755f7fee2
The last five tags (that start with a number) are used as version
numbers and linked to. This updates the sphinx extension so that
every user of the theme gets this info automatically with no need
to update the conf.py on a per-project basis.
Change-Id: I9bf17872bd23bed3cab9b5e2349d615c7001cb66