This patch enables building .pdf documentation using new 'pdf-docs'
tox environment. The newly created tox environment creates latex
source codes using sphinx-build and then builds the pdf
documentation using make.
Story: 2006070
Task: 35470
Change-Id: Id93200ae85c25dfb713e96a09d2ee4aea611ed33
Switch to openstackdocstheme 2.2.1 version. Using
this version will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems
Update Sphinx version as well.
Disable openstackdocs_auto_name to use 'project' variable as name.
Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.
openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.
See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html
Change-Id: I0d5889f8f4a846e06c1fdcb69c603c6a4c0b8ba0
Tempest defines its scope as only what is accessible through the
various REST APIs. Some cloud features cannot be properly tested when
using only the REST API. The whitebox-tempest-plugin is a Tempest
plugin whose scope explicitly requires peeking behind the curtain. In
other words, if a feature or behavior can be fully tested using only a
REST API, such a test does not belong in whitebox-tempest-plugin. On
the other hand, if fully testing a feature or behavior requires
accessing the control plane like a human operator or admin would, such
a test belongs in whitebox-tempest plugin.
Change-Id: Ic63f35b238d4410a438c99d228a932b3fa3ec98c
* Update to newer openstackdocstheme, remove settings from conf.py that
are default now.
* Remove unused autodoc extension.
* Remove unused and obsolete settings from setup.cfg
Change-Id: I5ea6c5ecb7325ebbb03f1baf476117db16bed46e
This commit updates sphinx library and treats warnings as errors. We
often miss doc warnings. So this commit makes them errors to build a
better html document.
Change-Id: I86fc23761ec24b0fdaae234cf37737dbc1bddd29
This commit removes redundancy in the index page, and classify the
implemented specifications projects.
Change-Id: I4ef35707be5f88c667d8f01060affbdd53338004
The commands used by constraints need at least tox 2.0. Update to
reflect reality, which should help with local running of constraints
targets.
Change-Id: I7ca8ecdaaf61337eaed2df9b0679097672ec53e6
We want to default to running all tox environments under python 3, so
set the basepython value in each environment.
We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.
We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.
Change-Id: I26a7a792569de63f6cd9dd1ee7416cdf7532f092
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
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.
Because this patch is generated by a script, there may be some
cosmetic changes to the layout of the YAML file(s) as the contents are
normalized.
See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html
Change-Id: Ib3ede35857bfd3dffd8af19be081ce09db89ee21
Story: #2002586
Task: #24327
While reading the README.rst to get ready to submit a spec
and I saw that Repository structure layout and the Expected
workflow section of the README.rst could be updated to
support the Repository directory structure.
Change-Id: I237ac8daecdbf21b11f0b62b0b1422eafe9523bf
This spec describes a proposed enhancement for testing multiple
policy actions for API tests that call API endpoints that enforce
multiple policies.
Specifies blueprint rbac-testing-multiple-policies
Change-Id: Id4b8debddbdb9f2c00d1e17328194d65b929211c
There is failure in doc due to old versions
of sphinx and oslosphinx.
This commit sync those version from g-r.
Change-Id: I5dcce891f3a41104c6dd822ab932be358556807e
Fix the Sphinx html_last_updated_fmt for Python3.
The 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: I2602ec196968dd37ea87899ef4a257e7519cecec
Closes-Bug:#1693670
The 0.13.1 release breaks some documentation jobs when it tries to build
docs with remote images. This has been reported upstream[0]. The version
matches the supported docutils versions for sphinx.
[0] https://sourceforge.net/p/docutils/bugs/301/
See I38580a5f765c7bb586dcf2786e91be15a8eba235
Change-Id: I5a8d134114495fd7013b4e06fbacc7f42a12d8d3
Since Iab676ae9bf95ee858c5e748c9579f7778e87bd77 , the negative test
framework has been removed. So this spec is never implemented.
In addition, we deleted never-implemented specs on the commit
I86331ac279b6a9cdb94ed4c43e5b0c41697e6a7d . So this patch removes
the corresponding spec.
Change-Id: Ic17a1a76f5ff0290f7e3d77a77fca5f0d85af034
list-plugins is done with If28311bc2e8d29a97ee46d7d73edba2a93aed7ce
centralized-workspaces is done with I9595e3ba809e457951a0ffdf4b15f641f2fec4f4
client-manager-refactor is done with I6a4845edb95031243bca12a8d03c60cf18528212
Change-Id: I7be211308debb82a7e08ca997f924adda5af1707
Since I41b42e02ff17f2d98862ddb11f137580abadafde , the stress test is
marked as deprecated in Tempest, and this development has stopped
1 year and 9 months ago.
So it is nice to remove this spec for the cleanup.
Change-Id: I11c1a251270daa6e66bf896a440307fafaab08b9