- add py3 to tox.ini (gate already tests py3)
- move all tests to $GITROOT/test so they can all run
through testr
- add scrapy to test-requirements.txt to support sitemap tests
- move tests from test_items.py to test_sitemap_file.py
- fix broken sitemap tests
- add newton to list of old releases in sitemap_file.py
- ignore flake8 H101 as it returns false positives for Sphinx conf.py
- Use openstackdocstheme for docs
- Update sitemap README
- Restructure repo docs
- fix minor style issues
Change-Id: I22c018149b2eefde6ca5c38c22ac06886fe9a7a8
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
Add links to the bug tracker and source in a way the release script can
find them.
Move the contributing instructions to a separate file, where github will
pick them up and the release tools won't be confused by the urls.
Change-Id: Icbc1fdde3245ef6aa750bd44601adb1514763034
Replace URLs for workflow documentation to appropriate parts of the
OpenStack Project Infrastructure Manual.
Change-Id: Ib947ebfc78ed80447d0b3b8895d9e96919fb1b00
This tool converts docutils native XML to docbook. The conversion is
done using XSLT, with some custom XML treatment.
The XSL source is a slightly modified version of Dn2dbk written by Éric
Bellot (http://ebellot.chez.com/dn2dbk/index.htm).
Modify doctest to check and build the HOT guide.
Implements: blueprint heat-templates
Change-Id: If866a5ffe19165c38981493684de550e0df0e36d
diff_branches.py generates a listing of the configuration options
changes that occured between 2 openstack releases.
This involves a few changes in other tools:
- the 'dump' subcommand for autohelp.py generates the serialized dict of
options
- add a special case for the 'bindir' option to avoid getting different
default values in different virtual environments
- the autohelp-wrapper -e switch builds the needed venv without
running autohelp.py commands
Change-Id: I80da172b91b8d2f0a15f89f4c812864da2fea471
https://review.openstack.org/#/c/94717/ triggered a bug in handling of
ignore_dirs: If a file in one of the ignored directories was changed, we
might still create dependencies for it and trigger an exception. Now we
remove also modified files in ignored directories.
Change-Id: I619d6c441a4fa4759e00d9c9e21c993707b19c6b
xml2po breaks the entities, readd the %openstack if needed.
Note: If more entities are imported in translated files, we need to
rework this completely.
Change-Id: Ia1a955f2cfc5810db21d68d5f9cc4374a42cebd2
Closes-Bug: #1322224
The High Availability Guide is currently written in ASCIIdoc, so
the tox scripts have to convert it to Docbook before continuing to
test. Remove all special casing needed for this.
Co-Authored-By: Andreas Jaeger <aj@suse.com>
Change-Id: I5a6c13e502d003237eb93d27028de2cb9db02e04
Implements: blueprint convert-ha-guide-to-docbook
Build all manuals, if an entity file is changed, we cannot do include
checks right now if an entity file is changed.
Update list of special files to handle, remove obsolete test.py and add
top-level pom.xml
Change-Id: I2c139249bb97fbd43781fafefd9f72e3f663935e
Patch https://review.openstack.org/#/c/94194/ changes the location
of the v3 API, handle the new directory.
Change-Id: Iadadec17d525acede71853c00ec4f075c75c0a05
The generatedocbook tool only works on XML files.
For the high-availability guide, we first need to generate the XML file
and then integrate translations - and take care that the build job not
regenerates the XML file.
Change-Id: Iab7a72d2819b4fc5d0bac53b8a9ccba2ba9ef0ef
- generate the tables in the doc/common/tables dir by default
- make the -i switch optional, and assume that git git repositories are
in a ./sources/ dir
- use elif's instead of multiple return statements in the subcommand
test
Change-Id: If96ac9df247cea5061c056328307ec88ab74a4f3
Add a new script that can reformat JSON files and check for niceness.
We can use this later as niceness check for openstack-doc-test.
Change-Id: I33c5309bfa2e1abfa6a35d1cfcdc984775e85f05
Non-breaking space is often not visible in our tools, or shown as normal
space. We should use instead. Warn about non-breaking space like
we warn about tabs.
Change-Id: I1bbbb1f19c56d3cc1b949df151b41886a0c46042
Related-Bug: #1314498
Change way on how the screens are generated so that we really
have </screen> on the closing line.
Also, update swift usage line so that it is not inside a screen but in a
normal para.
Add new option --output-directory for defining the directory where the
files will be written to.
Change-Id: Ie5d039ad673290720993586bd137c51183afa822
The code for parsing existing tables didn't find all the options because
of spaces and new lines. This patch should now handle those characters.
Change-Id: If6a5d8812e6e6f46e14944578cc5eb94d8374ccf
The generatedocbook command only handled books in subdirectories of
./doc. This assumption only works for operations-guide and
openstack-manuals but not for the api-site. Add parameter --root to give
the root directory. For the api-site, this would be "--root ./".
Change-Id: I9f477239677ca5a32b19bd565f8a37288f7e869e