This commit is part of a series to retire the Packaging Deb
project. Step 2 is to remove all content from the project
repos, replacing it with a README notification where to find
ongoing work, and how to recover the repo if needed at some
future point (as in
https://docs.openstack.org/infra/manual/drivers.html#retiring-a-project).
Change-Id: Id5c758d0c81166d0f591d95d335d5bfefd77fc5e
Update to use current openstackdocstheme everywhere instead of
oslosphinx, remove now obsolete settings.
Change-Id: I812f72ebf9fb4d96b1031880c44596833da9d384
It doesn't work as expected ('r', 's', or 't' instead of 'rst') and we
only provide one option anyway.
Change-Id: I4300264d7f919fb2041b10ee5d9f6e246c443377
Remove entries that have no content, rename indices section to search
since that is the remaining entry.
Change-Id: I167caa2cc0e99d370ca3ea10edd96fe1ba482d54
Add link to current release notes, use https and fix a layout problem.
Add two new subsections so that not all releases show up in the table of
content and clutter it.
Change-Id: I56444568a671b2bf6c052bc2a17f129c5dcf43e3
Enable log-a-bug feature and add information on when document was built.
Disable pep8 check for doc/source/conf.py.
Change-Id: Ia86791ac69845572b2fbc536732afcf901bcf203
- 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
This patch updates the _format_opt method to return a dict instead of a
list. This makes the RST templates easier to read and maintain.
Change-Id: Ia1b494b8ec8ed1e523ebe7198bcba00594e21ac5
Per the comment on change 'If0cf66aa9', we no longer track swift config
files as part of openstack-manuals. As such, we can remove the special
casing for this project.
Change-Id: I135caa57e1dcdd4114033276d89fc87c28a71aac
Python-cinderclient does not use the latest Block Storage API.
As work around, we need to set OS_VOLUME_API_VERSION environment
variable explicitly so that we can generate all commands.
Change-Id: I5de94f1fd5e8a4068cb7209062588eb6ade73fc8
Closes-Bug: #1673425
I already have a (sizable) openstack-manuals repo cloned locally and it
would appear tox does not work in a nested repo. Provide a way to
override this option.
Change-Id: I4ef80825598cc7d98a4046afd5b131484e5a3469
Support for flagmappings was useful in the days before OptGroup was
available. Today, it's mostly a burden and not necessary for projects
such as nova. Make this feature optional, allowing us to make use of
built-in oslo.config where available.
The actual flagmapping files themselves are found in another project and
cannot be removed here. This will be done in a separate change.
Change-Id: I27296954ad8ce2010fc464ad81c8da4859ba2531
We're going to add another code path for projects that rely on
oslo.config's 'OptGroup' to group their options. To minimize
duplication, we should drag the option formatting into its own
function.
Change-Id: I755489036758d589240d9c057e6fcb109de68fde
There's a rather complicated bit of code used to split blocks of text
into paragraphs. Replace this with something a little simpler that makes
use of our paragraph-ization rather than trying to rebuild blocks of
text.
Change-Id: I321ba57d0f7090afec34c6207f9a42493b8a3249
There is support for displaying deprecation information in a somewhat
structured manner (proper lists, emphasis on titles, etc.). However, the
deprecation information is still included in the help text rather than
in this flags section. This makes things more difficult than they need
to be.
Resolve this by instead including any deprecation information in the
flags section. This will transform output from something like this:
(String) DEPRECATED: Host to locate redis. Replaced by
[DEFAULT]/transport_url
to this:
(String) Host to locate redis.
Deprecated
Replaced by [DEFAULT]/transport_url
Which should be a little more obvious.
It's necessary to fix the template, which added the flags at the same
level as the title and description, resulting in varying numbers of
bullet points for the list.
Change-Id: Ifaee90a814fa3efee8b41eb0411535cff70e7309