This commit adds an .htaccess file to the tempest docs to handle
redirecting old paths to the new location. Before the docs migration in
the past we had docs located at docs.openstack.org/developer/tempest and
now things are located in docs.openstack.org/tempest/latest. With this
file we should be properly redirecting old links to the new location.
Change-Id: Idec7b2f299ade9b7dcc678ea1daf8daa25f08c44
This commit adds a flag to generate a tempest plugin list. In a local
environment, we don't need to generate a tempest plugin list, always
when we just need to see the other documents. Besides, generating the
tempest plugin list takes a long time. When GENERATE_TEMPEST_PLUGIN_LIST
environment variable is 'true'(default), the plugin list is created.
When the other value such as 'false' is specified, it isn't.
Change-Id: I6fd3cb3045ba8bbfb39c597413e13faa3cd24ae3
This commit removes 'html_use_smartypants' config in the doc conf.py.
The config option is already deprecated. And we don't need it in the
quoted double-dashes.
Change-Id: I1884abdb6bcab606879f4d90d604fdf2dee78c7d
html_last_updated_fmt option is interpreted as a
byte string in python3, causing Sphinx build to break.
This patch makes it utf-8 string.
Change-Id: If9104f4b56cd22fed87c596f990350ea877d83b6
Closes-Bug:#1693670
This commit updates the document theme. It is clear, simple, up-to-date
and beautiful. And this commit also updates section headers to fix the
document index.
Change-Id: Ia1e8e16e5f5ddb06e4c4ccb4979b0750b88a4db4
With pbr 2.0 and Sphinx 1.5, the setting for treat sphinx warnings as
errors is setting warning-is-error in build_sphinx section. Migrate
the setting from the old warnerrors one.
There are a couple of small items to be cleaned up.
Change-Id: I01b1ac49c69d001ea25a475d903311d0b592656e
Tempest doesn't build docs in any format except for HTML. We can remove
all of the cruft for other builders.
Change-Id: I0011e4bfdf6fdeb560e5f8a39a8077c80501c79e
When building packages if git is absent, then we should not set
html_last_updated_fmt. It can still be set via the -D switch
when building with sphinx-build.
Change-Id: Icfeb9354fff36776f5c83d3da3ab39ce2bb1dfb3
Closes-Bug: #1552251
This commit adds running the plugin registry generation script to the
sphinx build. This ensure that every time we build the docs we'll have
an up-to-date plugin registry. This comes at the cost of increased
build time since the script will query openstack's git server to get
the plugin list. Also, the plugin-registry source file was added to
.gitignore since it is autogenerated now.
Change-Id: Ib26124c5d5d5ef4617e4e702e594ce7f1795ce23
This commit moves the oslo config generator config file from living as
a data file, which makes it very difficult to rely on, to just living
in the package. By including it in the package we have a guaranteed
relative path we can rely on for building utilities on it, like the
tempest init command.
Change-Id: I5b9deae733f42fe3ed39418103304f71b43dccb3
Partially-implements: bp tempest-run-cmd
This commit disables SmartyPants feature for docs because it renders
'--' to '–'(–) but it's not good for command options.
Change-Id: Ic5ef2c648e9e888dc8ce19c4038c39842b66cfd9
os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.
Change-Id: I0751dbda085922d5e390cb7a19a9e832d399e20b
Partial-Bug: #1529836
Init command was not working properly as it could not locate the
configuration sample file.
Steps taken:
- Move config-generator.tempest.conf to etc so it will be installed
with pbr.
- Update all files with new path to config-generator-tempest.conf as
needed.
- Refactor init command so if it detects we are not in a virtual
environment, try to find the global config directory /etc/tempest.
If that fails fallback to [sys.prefix]/etc/tempest.
Closes-Bug: #1491058
Closes-Bug: #1490670
Change-Id: I960bc711ff78ac2b0441ef63dff8ec4fb268fd3a
This commit switches to using the oslo.config sphinx extension to
generate a sample config instead of doing it manually in the docs'
conf.py module.
Change-Id: I7032cb4f56c728911ffa5c6911eb504f53bc80af
The expectation from users is that to build docs locally all you need
to do is run build_sphinx on the repo and the docs will be fully
created. When we added the sample config to the tempest docs we ignored
this and just added the sample config generation to the docs tox job.
This commit fixes this by baking in the sample config generation to
the sphinx conf.py file which should ensure we have the sample config
generated every time that we call build_sphinx.
Change-Id: Ifd570707847f52592f5bc9bc743b8d3c98512639
Remove intersphinx from the docs build as it triggers network calls that
occasionally fail, and we don't really use intersphinx (links other
sphinx documents out on the internet)
This also removes the requirement for internet access during docs build.
This can cause docs jobs to fail if the project errors out on
warnings.
Change-Id: Icdb04bbe9eb931b07e7363ebb852fa9e73b088ea
Related-Bug: #1368910
This commit moves switches tempest from the d2to1 version of pbr and
move to the latest version of pbr. However, there is a bug with
build_spinx so it doesn't work with a doc version set so that section
is removed from the doc conf.py.
Change-Id: I4fe14eb2b2e81132f8fa99936a031176b38c437b
This commit updates the docs conf.py to make it more closely resemble
what is used it other projects(based on nova's equivilent file). It
also removes listing Sean Dague as the sole author for the Tempest
docs because it is a collaborative effort. It also fixes a pep8
failure on the imports.
Change-Id: I535858dc9d413e8d5f92d44194137f615390d117
bug 1192692
Sphinx isn't configured to load the tempest modules,
so the easiest fix is to remove the links to the
general and module indices (which don't exist).
Change-Id: Ic33e0b6ce56cb31fa51b4cdce25524d40191235d
adjust the index file to be more readable for the field guide
adjust titles to make more sense when displayed in top level index
change theme to 'nature', which is closer to the openstack default
style. Will eventually write our own style here.
Change-Id: I4f5fed65f9e26a4e4d333b1be4ed02c9ec246b9a
This is a first bit of experiment to get a doc tree for tempest
that will publish our doc content to the web as part of a larger
QA doc guide.
Update some of the base READMEs to be a little more accurate,
now that we're going to be pushing them to the web.
Added tox [venv] to ensure that docs get built
Change-Id: Id54e8fbc1d884525087630106e17b37dc1206cc9