openstack/placement
Code Issues Proposed changes

fix developer docs on API

Browse Source 
During the defcore discussion about the fact that the extensions
facility was deleted from Nova, folks pointed to this doc and the word
extensions to state that it was clearly still supported. There are
many levels of confusion there.

This tries to crisp up the introduction and links to the API docs for
Nova.

Change-Id: Ic0be29fb14bfb00ed7691439318325967d138dc9
This commit is contained in:
Sean Dague 2016-06-22 15:06:12 -04:00
parent a90f436b34
commit 6b8fc8f0cc
1 changed files with 9 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/source/index.rst
View File

@ -41,37 +41,29 @@ current development process and policies.
Compute API References Compute API References
====================== ======================
Nova has had a v2 API for a long time. We are currently in the process of The Nova compute API is quite large, we provide a concept guide which
moving to a new implementation of that API, which we have called v2.1. v2.1 gives some of the high level details, as well as a more detailed API
started life as an API called v3, but that name should never be used any more. reference.
We are currently in the process of transitioning users over to the v2.1
implementation, at which point the v2 code will be deleted.
* `v2.1 (CURRENT)`_ The API reference covers all versions of the API. Version 2.0 and
* `v2 (SUPPORTED)`_ and `v2 extensions (SUPPORTED)`_ (Will be deprecated in Version 2.1 are actually the same API, and Version 2.1 evolves forward
the near future.) with microversions. The API ref starts with the base API version, and
specifies all changes that exist to it as microversions roll
Changes to the Compute API post v2.1 are made using microversions. You can see a history of our microversions here: forward. You can also see a history of our microversions here:
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
api_microversion_history api_microversion_history
We also publish end-user API docs as an API Guide.
* `Compute API Guide`_
.. _`v2.1 (CURRENT)`: http://developer.openstack.org/api-ref-compute-v2.1.html
.. _`v2 (SUPPORTED)`: http://developer.openstack.org/api-ref-compute-v2.html
.. _`v2 extensions (SUPPORTED)`: http://developer.openstack.org/api-ref-compute-v2-ext.html
.. _`Compute API Guide`: http://developer.openstack.org/api-guide/compute/ .. _`Compute API Guide`: http://developer.openstack.org/api-guide/compute/
.. _`Compute API Reference`: http://developer.openstack.org/api-ref/compute/
There was a session on the v2.1 API at the Liberty summit which you can watch There was a session on the v2.1 API at the Liberty summit which you can watch
`here <https://www.openstack.org/summit/vancouver-2015/summit-videos/presentation/introduction-of-a-new-nova-rest-api-why-we-need-to-use-nova-v2-1-api>`_. `here <https://www.openstack.org/summit/vancouver-2015/summit-videos/presentation/introduction-of-a-new-nova-rest-api-why-we-need-to-use-nova-v2-1-api>`_.
Feature Status Feature Status
============== ==============