diff --git a/docs/guides/onap-user/instantiate/instantiation/nbi/index.rst b/docs/guides/onap-user/instantiate/instantiation/nbi/index.rst
index 96bbc3a..28ef5d9 100644
--- a/docs/guides/onap-user/instantiate/instantiation/nbi/index.rst
+++ b/docs/guides/onap-user/instantiate/instantiation/nbi/index.rst
@@ -16,7 +16,7 @@
    :maxdepth: 1
    :titlesonly:
 
-   NBI Guide <../../../../../submodules/externalapi/nbi.git/docs/offeredapis/offeredapis.rst>
+:ref:`NBI Guide<onap-externalapi-nbi:offeredapis>`
 
 
 ONAP NBI will convert that request to ONAP SO request.
diff --git a/docs/guides/onap-user/instantiate/instantiation/uui/index.rst b/docs/guides/onap-user/instantiate/instantiation/uui/index.rst
index fa57be2..70d825e 100644
--- a/docs/guides/onap-user/instantiate/instantiation/uui/index.rst
+++ b/docs/guides/onap-user/instantiate/instantiation/uui/index.rst
@@ -11,4 +11,4 @@
    :maxdepth: 1
    :titlesonly:
 
-   ../../../../../submodules/usecase-ui.git/docs/platform/installation/user-guide/index.rst
+:ref:`usecase-ui docs platform installation user-guide<onap-usecase-ui:master_index>`
diff --git a/docs/guides/onap-user/instantiate/instantiation/vid/index.rst b/docs/guides/onap-user/instantiate/instantiation/vid/index.rst
index d6b0824..9b367f9 100644
--- a/docs/guides/onap-user/instantiate/instantiation/vid/index.rst
+++ b/docs/guides/onap-user/instantiate/instantiation/vid/index.rst
@@ -10,4 +10,4 @@
    :maxdepth: 1
    :titlesonly:
 
-   ../../../../../submodules/vid.git/docs/instantiate.rst
+:ref:`vidgit docs instantiaterst<onap-vid:instantiate>`