doc: minor corrections to the API version docco

Miscellaneous corrections for grammar and clarity.

Change-Id: Ibec4d907a074cf37b2a007011e1fd82c90633b39
This commit is contained in:
Eoghan Glynn 2016-01-07 11:32:21 +00:00
parent a20f5512c0
commit 73e979d419

View File

@ -85,18 +85,17 @@ links and MIME types to available versions.
]
}
The API with ``CURRENT`` status is the newest API and continue improved by the
Nova project. The API with ``SUPPORTED`` is the old API and new features is
frozen. The API with ``DEPRECATED`` status is the API will be removed in the
The API with ``CURRENT`` status is the newest API and continues to be improved by the
Nova project. The API with ``SUPPORTED`` status is the old API, where new features are
frozen. The API with ``DEPRECATED`` status is the API that will be removed in the
foreseeable future. Providers should work with developers and partners to
ensure there is adequate time to migrate to the new version before deprecated
versions are discontinued. For any API which is under development and didn't
release yet, the API status is ``EXPERIMENTAL``.
versions are discontinued. For any API which is under development but isn't
released as yet, the API status is ``EXPERIMENTAL``.
Your application can programmatically determine available API versions
by performing a **GET** on the root URL (i.e. with the version and
everything to the right of it truncated) returned from the
authentication system.
everything following that truncated) returned from the authentication system.
You can also obtain additional information about a specific version by
performing a **GET** on the base version URL (such as,