diff --git a/doc/source/contributor/code-review.rst b/doc/source/contributor/code-review.rst
index 8ce8e05524bc..3d42f650170d 100644
--- a/doc/source/contributor/code-review.rst
+++ b/doc/source/contributor/code-review.rst
@@ -234,6 +234,8 @@ If a new microversion API is added, the following needs to happen:
 
 * A new patch for the microversion API change in python-novaclient side
   should be submitted before the microversion change in Nova is merged.
+  See :python-novaclient-doc:`Adding support for a new microversion
+  <contributor/microversions>` in python-novaclient for more details.
 * If the microversion changes the response schema, a new schema and test for
   the microversion must be added to Tempest. The microversion change in Nova
   should not be merged until the Tempest test is submitted and at least
diff --git a/doc/source/contributor/microversions.rst b/doc/source/contributor/microversions.rst
index 35df8309866b..c9610c850bb9 100644
--- a/doc/source/contributor/microversions.rst
+++ b/doc/source/contributor/microversions.rst
@@ -368,6 +368,8 @@ necessary to add changes to other places which describe your change:
 
 * Make a new commit to python-novaclient and update corresponding
   files to enable the newly added microversion API.
+  See :python-novaclient-doc:`Adding support for a new microversion
+  <contributor/microversions>` in python-novaclient for more details.
 
 * If the microversion changes the response schema, a new schema and test for
   the microversion must be added to Tempest.