diff --git a/doc/source/index.rst b/doc/source/index.rst
index 16fd337e8..8fd62912e 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -76,13 +76,21 @@ resources will help you get started with consuming the API directly.
concept guide for the API. This helps lay out the concepts behind the API to
make consuming the API reference easier.
* `Compute API Reference `_:
- The complete reference for the API, including all methods and request /
- response parameters and their meaning.
-* :doc:`API Microversion History `: The
- compute API evolves over time through `Microversions
+ The complete reference for the compute API, including all methods and
+ request / response parameters and their meaning.
+* :doc:`Compute API Microversion History `:
+ The compute API evolves over time through `Microversions
`_. This
provides the history of all those changes. Consider it a "what's new" in the
compute API.
+* `Placement API Reference `_:
+ The complete reference for the placement API, including all methods and
+ request / response parameters and their meaning.
+* :ref:`Placement API Microversion History `:
+ The placement API evolves over time through `Microversions
+ `_. This
+ provides the history of all those changes. Consider it a "what's new" in the
+ placement API.
* :doc:`Block Device Mapping `: One of the trickier
parts to understand is the Block Device Mapping parameters used to connect
specific block devices to computes. This deserves its own deep dive.
diff --git a/doc/source/user/placement.rst b/doc/source/user/placement.rst
index 21f327579..18d7bdb6e 100644
--- a/doc/source/user/placement.rst
+++ b/doc/source/user/placement.rst
@@ -245,4 +245,6 @@ nova-compute service could be Newton level code making requests to an Ocata
placement API, and vice-versa, an Ocata compute service in a cells v2 cell
could be making requests to a Newton placement API.
+.. _placement-api-microversion-history:
+
.. include:: ../../../nova/api/openstack/placement/rest_api_version_history.rst