From 3121341aa60dbabad8fb0822d63bf14f27bcbb7b Mon Sep 17 00:00:00 2001
From: "Mark T. Voelker" <mvoelker@vmware.com>
Date: Sat, 17 Sep 2016 01:31:48 -0400
Subject: [PATCH] Document Cinder's CURRENT API

Cinder's CURRENT API changed from v2 to v3 in Mitaka[1], but no API
reference was ever written.  Having the CURRENT API undocumented is
clearly something we should fix.  An API refernece for v3 has now been
submitted to the Cinder team[2], and this patch updates the index once
it lands.

[1] https://review.openstack.org/#/c/224910/36/cinder/api/versions.py
[2] https://review.openstack.org/#/c/371898/

Change-Id: Ibecca6e4c9489b3a2cc44863551795e25fcc2ccc
Related-Bug: #1616072
Depends-On: Ia3a8050cd04ad3a487a79d80acf9691feee6182e
---
 api-quick-start/source/index.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/api-quick-start/source/index.rst b/api-quick-start/source/index.rst
index 2de82fc40..125c8594c 100644
--- a/api-quick-start/source/index.rst
+++ b/api-quick-start/source/index.rst
@@ -11,7 +11,11 @@ Current API versions
 
 `Bare Metal API v1 <http://developer.openstack.org/api-ref/baremetal/>`__ (microversions)
 
-`Block Storage API v2 <http://developer.openstack.org/api-ref/block-storage/v2/>`__
+`Block Storage API v3 <http://developer.openstack.org/api-ref/block-storage/v3/>`__ (microversions)
+
+.. note:: The Block Storage API v3 is functionally identical to the
+   Block Storage API v2. Subsequent API v3 microversions, such as v3.1,
+   differ from API v2.
 
 `Clustering API v1 <http://developer.openstack.org/api-ref/clustering/>`__
 
@@ -44,6 +48,8 @@ Current API versions
 Supported API versions
 ----------------------
 
+`Block Storage API v2 <http://developer.openstack.org/api-ref/block-storage/v2/>`__
+
 `Image service API v1 <http://developer.openstack.org/api-ref/image/v1>`__
 
 Deprecated API versions