diff --git a/doc/source/admin/upgrades/compatibility-matrix.rst b/doc/source/admin/upgrades/compatibility-matrix.rst
index d7f49148ff..5cf614a5aa 100644
--- a/doc/source/admin/upgrades/compatibility-matrix.rst
+++ b/doc/source/admin/upgrades/compatibility-matrix.rst
@@ -1,6 +1,9 @@
+.. _compatibility-matrix:
+
 Compatibility Matrix
 --------------------
 
+
 All of the OpenStack-Ansible releases are compatible with specific sets of
 operating systems and their versions. Operating Systems have their own
 lifecycles, however we may drop their support before end of their EOL because
diff --git a/doc/source/contributors/distributions.rst b/doc/source/contributors/distributions.rst
index 62102d6599..e21ff58210 100644
--- a/doc/source/contributors/distributions.rst
+++ b/doc/source/contributors/distributions.rst
@@ -8,7 +8,7 @@ Supported distributions
 =======================
 
 The list of supported distributions can be found in the
-:deploy_guide:`Deployment Guide <deploymenthost.html>`
+:ref:`compatibility-matrix`
 
 Minimum requirements for OpenStack-Ansible roles
 ================================================