Set up the variables the same way the post job is set up:
Pass them in via environment in job definition.
Pass ZUUL_ environment variables through to jobs.
Note ZUUL_REFNAME is not set, use ZUUL_BRANCH instead.
Change-Id: I5863a05384c9a48445d5ce52ccc508519c7c00f8
We do not need this tox environment anymore, remove it.
Also, update documentation for jobs with Zuul v3.
Change-Id: I226835ad57af775a77e4719c5dcf7d13010ebd76
The parent patch added a linters environment as an alias for
checkniceness. This makes linters the "real" environment and
checkniceness the alias.
Change-Id: I9778abf3315e62f9db2a8d98dfb4bc5e9e2e869d
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
As part of migration to zuul v3, replace checkniceness by linters tox
target to use a more "common" target accross OpenStack.
Remove the msgfmt check, this is now done in the translation sync
scripts, so no need to run it again here.
Change-Id: Ie50dba2c1eb7cbb2ce4d3ddf5b35dddaf355cb7f
Add a file containing the tests for all of the redirect rules and set
up whereto to run during the check. The test file is a template, just
like the htaccess file, to ensure we auto-generate the rules for all
of the various project redirects.
Fix a few issues with the template generator that ended up producing
duplicate or useless rules.
Change-Id: I0d306149dc33f64d44d9482fab02101bd1f6d7f5
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
No need for build-install-guides-rst.sh, move to build-all-rst.sh.
Simplify build-all-rst.sh since we now do not have versioned or draft
docs anymore.
Change-Id: I213eff811d83ddfb1da3bb15dd8c99adeec93eb9
We do not build and translate docbook XML anymore, so do not need
Generatedocbook anymore. Remove the now obsolete comment and also the
sitepackages usage that was only needed for these.
Change-Id: I383a09b557f67bf490f9bfa4b9e30ebe416d95ac
There are some doc8 rules which would be valuable for these
autogenerated files (like whitespace checks), however, some others do
not make any sense (mainly line length). As it does not appear to be
possible to use wildcards for the 'ignore-path-errors' setting, so we
must disable all checks on the files themselves.
Change-Id: I0adc353d1f1c975ae788a8e38d9c9b12168b23e5
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
Test that glossary entries are sorted and fail the niceness test if not.
Sort those entries that were not sorted.
Change-Id: I40eec5e6132bd79899456de505406ac2fa4ca32f
Major reorganization and rewriting of deployment examples to
use "building blocks" that enable the audience to begin with
a simple architecture and add complexity as necessary. Also
reduces duplication of content.
Configuration and commands reference Mitaka to ease backporting
to Mitaka. After merge, I will submit another patch to update
the configuration and commands for Newton.
Macvtap content needs a significant rewrite to integrate
better with the deployment examples. Will address in Ocata.
Change-Id: I2ae95d726aa053a0f30507a3e68907ac56296e6b
backport: mitaka
There have no direction openstack/common in this project,so
we can delete it.
And the H803 has been deprecated,so we can delete it either.
More details:https://github.com/openstack-dev/hacking/blob/master/setup.cfg
Change-Id: If9bbdad02f836128909525f09c0f77ac0a6effd2
With the options given to sphinx, we regenerate releasenotes , there's
no need to rm -rf the content before - it will only break a proposed
way to translate the content.
Change-Id: I17d72f3561c25c0d7dd7f1c9ec09c57c1e8df798
Require the new release and remove openstack-doc-test from
checkniceness, this was only needed for docbook XML files.
The command does not exist anymore.
Change-Id: I88c39f3c85935300c0377c028997f5009969b373
This is needed for some OpenStack CI testing, it will be removed once
the job is working correctly.
Related Change: I7343d54185a896b847d6340532bdab22465e98f0
Change-Id: Ib6d45031866790ee73000cf514e1263a7e8dff69
To simplify the build tool chain,
factor out Install Guide for Debian with debconf.
Continueously, keep Install Guide for Debian without debconf
in the doc/install-guide directory. Also, use the contents
at doc/install-guide as possible for consistency.
On the following patches, clean up doc/install-guide sources
to cleanup the contents and build tool chains.
Change-Id: I8df6b3b382137d08d60f85bc41bcd98ac1f4eb47
Since we do not build DocBook XML anymore, we have removed the jobs for
this and thus can remove the support for these also from tox.ini.
checksyntax, checklinks and checkdeletions are DocBook XML only targets,
so remove them.
Change-Id: Iaa663c03fd6e2976208e20ba03dbab4d8d82b2ce
Depends-On: I9f5944eb9db06fe2ff9088f22048c198b2921237
We do not need the DocBook XML glossary anymore, since we do not build
any DocBook guides that use it.
Add instead the RST version of the document to git.
Adjust scripts to not build or publish the glossary anymore.
Change-Id: Id4bfef7666690e6d08291f664751db7a4d4d5983
Move release notes into releasenotes and add tox target so that
infra scripts will publish them to
docs.openstack.org/releasenotes/openstack-manuals
Infra change: Icbe135e37c78e0a3a1c6d3243f7128c0b881325d
Note that the directory layout here is this way on purpose - we want to
reuse the same jobs other repos use, just the difference is we're not
using reno for this.
Change-Id: I00a53d8b3d9bef28b480be22af2e6647fa26448a
"pipeline" must be only one line in ceilometer-swift.rst, which it
easy to misguide deployer to four lines before this patch set.
Change-Id: I2c2af5d026b335394660780913c9bbb2392e3b7c
Prepare the networking guide for Liberty/Mitaka updates as
follows:
1) Change "legacy" to "classic" to provide a more positive
connotation of such scenarios. Legacy should refer to
nova-network.
2) Replace underscore with hyphen in filenames to meet
conventions.
3) Replace :doc: with :ref: to minimize impact of future
file renames.
Change-Id: I95bdd84b4a01cd9cbd06cad66821ad810295394f
backport: Liberty
As discussed via email, let's do this on a smaller scale.
This reverts commit 9432a6da0cc341a879bc6f4ac48380248355e77a.
Change-Id: I27e9cd06c5d69917abe452e873873683e10c282a
With this environment it is possible to build a single RST guide with
the following common: tox -e build -- NAME
E.g. to build the contributor guide run the following command:
tox -e build -- contributor-guide
Change-Id: I94cf504eece14b2b8d2734cb5b4c16a1b409026f
Enhance file so that it can be used by other documentation repos as
well.
Update invocation of it.
Change-Id: I93a6d8ccb8c314c0961b87a239462183712cdd26
Check RST files for valid links.
This is a separte target for now to evaluate how useful it is.
Whitelist build.opensuse.org URL for user-guide.
Remove also checklang from default tox invocation since it's not needed
to run by default.
Change-Id: I6c275518b9e55ab3b6bcea52894ea851924bee94
With this patch, the RST files have no line longer than 79 chars -
as discussed on the docs mailing list - and we
can gate on it. Previously this limit was 100 chars.
Change-Id: I23f550db81e9264649d0444f5f1ba1be0d6d343d
Add support for conditionals for the Install Guide.
This uses the tags:
* rdo
* obs
* ubuntu
Note that this is changed from the spec since sphinx does not accept a
"-". Also, I changed from opensuse to suse for brevity.
Adds new tox target so that "tox -e install-guides" builds only the
RST Install Guide.
implements bp installguide-liberty
Change-Id: Ibdfbc7ff294e56f52cd6f4ef59ceeb7b6af3e28a
We aim to have no lines longer than 79 characters, enable the line
checking niceness check but set it to 100 as current maximum.
Convert files that fail this line length.
Convert one table to a definition list, convert two tables to use
list-table directive.
Change-Id: I8d0a95cc1c8e72965b3e0e69445e7b2bc6d77f0f
Remove separate build-user-guides.sh and create a new build-all-rst.sh
tool.
Remove networking tox environment, since the RST guides share files, we
should always build them together using the docs tox environment.
Change-Id: I7ef98ca5e134096e14c79d58b0fc62a07747e471
openstack-doc-tools 0.28 contains a fix for translation of RST guides
and the User Guides. Require that version and enable the User Guides for
translation.
Add building of glossary for translation environments to tox.ini.
Change-Id: I645bf98b68603811a9a978e508d1f492e44da738
The two tox environments were large and mostly duplicated, use a shell
script instead and use the build-rst.sh script to simplify building and
publishing.
For copying to /kilo, use the tools/copy-to-branch.sh script instead of
the simple commands since that is more robust. Merge that script into
this script, no need for a second script.
Update requirements: We need 0.27 at least to not have to delete the
Debian Install Guide, sync also pbr with global-requirements.txt.
Change-Id: Ieba77b4e3d0bbe58db041206d9725c523b3bb43a
Separate User Guides cleanly, there's little benefit in having them in
one directory and it causes quite some strange sphinx challenges.
Temporarily disable translation of the guides since first a new release
of openstack-doc-tools is needed.
Partial implements bp reorganise-user-guides
Change-Id: I9e41bb67397c5bc26c1940f67387f3e42a9c5cbc
If no documents are published to /draft, the "cp -a" would fail, rewrite
it so that it always succeeds.
If any command fails, nothing gets uploaded ;(
Change-Id: Ib9c6254504f868fd1a8eb772d5df9651448adc42
Publish draft documentation on docs.openstack.org/draft.
For now these are all Install Guides and the French Image Guide.
Update wiki pages for new links.
Partially implements bp draft-publishing
Change-Id: I319a52f7bc9982ab172fbbbaeb0a22a7642b5b07