diff --git a/doc/source/index.rst b/doc/source/index.rst
index 39158cbaf..b547e6464 100755
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -73,7 +73,7 @@ Security
 .. toctree::
    :maxdepth: 2
 
-   security/index
+   security/index-security-84d0d8aa401b
 
 
 --------------------
diff --git a/doc/source/security/index.rst b/doc/source/security/index-security-84d0d8aa401b.rst
similarity index 78%
rename from doc/source/security/index.rst
rename to doc/source/security/index-security-84d0d8aa401b.rst
index 7439ea03d..ea5139464 100644
--- a/doc/source/security/index.rst
+++ b/doc/source/security/index-security-84d0d8aa401b.rst
@@ -1,3 +1,5 @@
+.. _index-security-84d0d8aa401b:
+
 ========
 Security
 ========
@@ -21,7 +23,7 @@ Kubernetes
 
 -   Keystone authentication and authorization of StarlingX API / CLI / GUI
 
--   Barbican is used to securely store secrets such as BMC user passwords
+-   Barbican is used to securely store secrets such as |BMC| user passwords
 
 -   Networking policies / Firewalls on external APIs
 
@@ -37,7 +39,7 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
-   kubernetes/index
+   kubernetes/index-security-kub-81153c1254c3
 
 ---------
 OpenStack
@@ -50,4 +52,4 @@ OpenStack
 .. toctree::
     :maxdepth: 2
 
-    openstack/index
\ No newline at end of file
+    openstack/index-security-os-a2375141dcc2
\ No newline at end of file
diff --git a/doc/source/security/kubernetes/index.rst b/doc/source/security/kubernetes/index-security-kub-81153c1254c3.rst
similarity index 98%
rename from doc/source/security/kubernetes/index.rst
rename to doc/source/security/kubernetes/index-security-kub-81153c1254c3.rst
index 42d81c75d..cb5c0d290 100644
--- a/doc/source/security/kubernetes/index.rst
+++ b/doc/source/security/kubernetes/index-security-kub-81153c1254c3.rst
@@ -1,10 +1,10 @@
-.. _security-kubernetes-index:
+.. _index-security-kub-81153c1254c3:
 
 .. include:: /_includes/toc-title-security-kub.rest
 
 .. only:: partner
 
-   .. include:: /security/index.rst
+   .. include:: /security/index-security-84d0d8aa401b.rst
       :start-after: kub-begin
       :end-before: kub-end
 
@@ -281,3 +281,4 @@ Appendix: Locally creating certificates
 
    create-certificates-locally-using-openssl
    create-certificates-locally-using-cert-manager-on-the-controller
+
diff --git a/doc/source/security/openstack/index.rst b/doc/source/security/openstack/index-security-os-a2375141dcc2.rst
similarity index 96%
rename from doc/source/security/openstack/index.rst
rename to doc/source/security/openstack/index-security-os-a2375141dcc2.rst
index 70faa7f8d..548019c20 100644
--- a/doc/source/security/openstack/index.rst
+++ b/doc/source/security/openstack/index-security-os-a2375141dcc2.rst
@@ -1,5 +1,4 @@
-
-.. _security-openstack-index:
+.. _index-security-os-a2375141dcc2:
 
 .. include:: /_includes/toc-title-security-os.rest