openstack/nova - nova - OpenDev: Free Software Needs Free Tools

In this change the new OpenStack-API-Version headers is allowed,
but not required, for requesting a microversion.
Both headers are accepted in the request and both headers are sent in
the response (both the header and its value, and the addition to the Vary
header).
Many tests which explicitly use a microversion header have been
updated to use both. This change is not 100% as most of the tests
are testing the handling of the value of the header, not which
header is involved.
Partially-Implements: blueprint modern-microversions
Change-Id: I68da13b5ba0c2f3357523e765a5b9db81899daf1

On Ubuntu 16.04 a tox package is for python3 by default
and this causes errors in building docs in tox enviroment.
In these changes iterators are replaced with lists where it's needed.
Also external command calls result are decoded from bytes to unicode.
Change-Id: I88ef54405b4bc13c269bdda55ae8289676311ee1

tweek => tweak
adminstrator => administrator
mulitple => multiple
definied => defined (2-locations)
Change-Id: Ibe2c04e1b225515f7a6c83b5a4a8d91e8385140a

This patch removes some redundant words.
Change-Id: I1461ad1d98272b0d6223fd989861885902c12617

server_concepts.rst contains some invalid JSON formats as samples.
This patch fixes them and improves the readability by adding some
spaces.
Change-Id: Ib51f9e1351fca51c15ffdcb98f42311b999f22f5

Since Id695f60e30b14f939973e3610c7750b83a14d0d0 , the endpoint /v1.1
has been removed. So it is nice to remove it from api-guide also to
avoid unnecessary confusions.
Change-Id: I1a70fec5568468c088f60986b9edd8bd1bf97314

Error on warnings in building the API guide and fix any problem
encountered:
* tox.ini: Enable tread warnings as errors
* index.rst: Add unreferenced file extra_specs_and_properties as
 hidden file so that it does not show up in index. It is still
 built and will be referenced from other files.
* general_info.rst: Remove reference to non-existing file
* server_concept: Add missing empty line after code directives
Also fix a typo and remove extra EOL whitespace.
Change-Id: Ie766f8d2f7d82b7b5b02541b342f9829ca4550a0

Change-Id: Ia7af1834c12e775de736c7afeaa529c63758bbe7

How to trigger crash dump depends on hypervisors. NMI is not the only way to
implement the feature. This patch modifies description regarding this feature.
Change-Id: I77d10551650776c06ee4b413f1b027abf6620e83

* typos
* reduntant words
* reworded sentences for clarity
Closes-bug: #1545748
Change-Id: I0700d04de38b34cf13988490873b8c34dad1005b

The all_tenants option was incorrectly described as being available
to general users.
Change-Id: I739da63b3d5460ff1ef8dcafd21d58829a3a4852

Change-Id: I40e3c0f3b99ae853f84609c5334e6d230dfff867

s/there there is/there is/
Change-Id: I3c352b97ca9e191834c933bfd31261fefda12d59

As extensions are already deprecated in Nova, this patch removes
all of the details about extensions, adds a note about the deprecation
of extensions, and points to documentation about microversions for
discovering API changes.
blueprint complete-todo-in-api-concept-doc
Co-Author: Ed Leafe <ed@leafe.com>
Change-Id: I56acfeac5b8b3312547c06d79962a79991c5c8f3

Add description for server trigger crash dump operation
into api-guide.
Change-Id: I20492dbf9eab4f7fcab0864bb250b20f98b762e4
blueprint complete-todo-in-api-concept-doc

Add descriptions for server query options and add some
samples for the query options.
Implement blueprint complete-todo-in-api-concept-doc
Change-Id: Id23a19ecc30f1837f4755ec898ef0389dcf23a8f

The format extensions concept (adding .json / .xml) is no longer
really a thing. The router supports it, but we only have json
responses, so there is no reason to advertise it.
Change-Id: I07ba13a98ce55c215c6b676b5ff41d7d60babfde

This patch adds basic interactive guideline.
blueprint complete-todo-in-api-concept-doc
Change-Id: I3c828e34c43fa681328f71694940f05c87d28e06

This patch adds basic guideline how to discover microversion with
version API.
blueprint complete-todo-in-api-concept-doc
Change-Id: I55b50e8300c67b9ec94587a2bdccac55a9c115a0

This patch adds last few use-cases for microversion.
blueprint complete-todo-in-api-concept-doc
Change-Id: Ib472c91289fc153e1462d5137eb1b5caebca9a2f

Miscellaneous corrections for grammar and clarity.
Change-Id: Ibec4d907a074cf37b2a007011e1fd82c90633b39

os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.
Change-Id: Iea9c0501f46c57d809217912fb0f40eb2bc4f111
Closes-Bug: #1529836 

To help add color to the API doc, we use a common set of persona when
talking about the use cases behind each API.
This is really just a quick sketch that adds TODOs for others to follow
up on, in order to complete the guide.
blueprint complete-todo-in-api-concept-doc
Change-Id: I71a07caa27f1b17d3256a5439e867c40fc9d0abd

Common usage is REST, and most in project are written as REST.
Change ReST to REST to comply with it.
Change-Id: I2c87f4c811f7dd64a3f5807a45eba2a82373da36

This patch adds the concept guide for certificate.
blueprint complete-todo-in-api-concept-doc
Change-Id: If44e5f4633ee47d235e8254904d950e7d81d39c1