openstack/nova
Code Issues Proposed changes

Edit the text to be more native-English sounding

Browse Source 
No substantial changes; just wanted to make the text sound more like
native English.

blueprint complete-todo-in-api-concept-doc

Change-Id: I9ff48113bf709f63e3654a5851aa8d6853b519b5
This commit is contained in:
EdLeafe 2015-12-08 13:54:21 +00:00 committed by Ed Leafe
parent 50aa74f91d
commit 231c9a1589
1 changed files with 14 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
api-guide/source/microversions.rst
View File

@ -15,22 +15,24 @@
Microversions Microversions
============= =============
API v2.1 supports Microversions. User uses Microversions to discover the API v2.1 supports Microversions: small, documented changes to the API. A user
supported API version in the cloud. If cloud is upgraded to support newer can use Microversions to discover the latest API version supported in their
versions, it will still support all older versions to maintain the backward cloud. A cloud that is upgraded to support newer versions will still support
compatibility for users using older versions. Also user can discover new all older versions to maintain the backward compatibility for those users who
features easily with Microversions, then user can take all the advantages of depend on older versions. Users can also discover new features easily with
current cloud. Microversions, so that they can benefit from all the advantages and
improvements of the current cloud.
There are multiple cases which you can resolve with Microversions: There are multiple cases which you can resolve with Microversions:
Legacy v2 API user with new cloud Legacy v2 API user with new cloud
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =================================
The minimum version of Microversions is `2.1`, this is a version compatible The minimum version of Microversions is `2.1`, which is a version compatible
with legacy v2 API. The legacy v2 API user don't need to worry about that his with the legacy v2 API. The legacy v2 API user doesn't need to worry that their
old client is broken with new cloud deployment. Cloud operator don't need to older client software will be broken when their cloud is upgraded with new
worry that upgrading cloud to newer versions will break any user with old versions. And the cloud operator doesn't need to worry that upgrading their
client. cloud to newer versions will break any user with older clients that don't
expect these changes.
TODO: add more use-cases for Microversions TODO: add more use-cases for Microversions