diff --git a/doc/source/configuration/reference/kolla-ansible.rst b/doc/source/configuration/reference/kolla-ansible.rst
index ce8eb8d88..fdf89c992 100644
--- a/doc/source/configuration/reference/kolla-ansible.rst
+++ b/doc/source/configuration/reference/kolla-ansible.rst
@@ -233,7 +233,7 @@ API Addresses
 .. note::
 
    These variables should be used over the deprecated ``vip_address`` and
-   ``fqdn`` `network attributes <configuration-network-global>`
+   ``fqdn`` :ref:`network attributes <configuration-network-global>`.
 
 The following variables affect the addresses used for the external and internal
 API.
diff --git a/doc/source/configuration/reference/routed-control-plane-networks.rst b/doc/source/configuration/reference/routed-control-plane-networks.rst
index 00e6ef156..95b2888e7 100644
--- a/doc/source/configuration/reference/routed-control-plane-networks.rst
+++ b/doc/source/configuration/reference/routed-control-plane-networks.rst
@@ -48,8 +48,8 @@ follows:
 
 * create groups in the inventory for the different sets of networks
 * place hosts in the appropriate groups
-* move ``vip_address`` and ``fqdn`` network attributes to `global variables
-  <configuration-kolla-ansible-api-addresses>`
+* move ``vip_address`` and ``fqdn`` network attributes to :ref:`global
+  variables <configuration-kolla-ansible-api-addresses>`
 * move global network name configuration to group variables
 * add new networks to configuration
 * add network interface group variables
@@ -177,8 +177,8 @@ Kolla API addresses
 -------------------
 
 Remove all variables defining ``vip_address`` or ``fqdn`` network attributes
-from ``networks.yml``, and move the configuration to the `API address variables
-<configuration-kolla-ansible-api-addresses>` in ``kolla.yml``.
+from ``networks.yml``, and move the configuration to the :ref:`API address
+variables <configuration-kolla-ansible-api-addresses>` in ``kolla.yml``.
 
 Network names
 -------------