(DOCSP-36944): Added smart links for top-level nav. (#686)

corryroot · web-flow · commit 07a57e0026dd · 2024-10-29T14:45:51.000-04:00
* (DOCSP-36944): Added smart links for top-level nav. * (DOCSP-36944): Incorporated Kailie's feedback.
diff --git a/source/chart-type-reference/natural-language-charts.txt b/source/chart-type-reference/natural-language-charts.txt
@@ -138,7 +138,7 @@ disable the AI feature:
 .. procedure:: 
    :style: normal 
 
-   .. step:: In your left navigation menu, click :guilabel:`AI features`.
+   .. include:: /includes/nav/steps-ai-features.rst
 
    .. step:: Set the toggle to off.
 
diff --git a/source/dashboards/dashboard-access/dashboard-ownership.txt b/source/dashboards/dashboard-access/dashboard-ownership.txt
@@ -33,7 +33,9 @@ To view the owners of any dashboard in your project:
 
    .. include:: /includes/nav/steps-charts.rst
 
-   .. step:: Click :guilabel:`Owners` under :guilabel:`Dashboards` in the sidebar.
+   .. include:: /includes/nav/steps-owners.rst
+
+   .. step:: Review the :guilabel:`Owners` table.
 
       |charts| displays a table with the following columns:
 
diff --git a/source/get-started-embedding.txt b/source/get-started-embedding.txt
@@ -54,7 +54,11 @@ Use the Getting Started UI
 
    .. step:: Open the :guilabel:`Getting Started` view.
 
-      Click the :guilabel:`Getting Started` tab.
+      If it isn't already displayed, click the 
+      :guilabel:`Getting Started` tab.
+
+      The `Getting Started <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fembedding%2Fgetting-started>`__ tab 
+      displays.
 
    .. step:: Configure the :guilabel:`How to embed` section.
 
diff --git a/source/includes/nav/steps-ai-features.rst b/source/includes/nav/steps-ai-features.rst
@@ -0,0 +1,6 @@
+.. step:: Go to the :guilabel:`AI Features` page.
+
+   Click :guilabel:`AI features` under the 
+   :guilabel:`Settings` heading in the sidebar.
+
+   The `AI Features <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fsettings%2Fai-features>`__ page displays.
diff --git a/source/includes/nav/steps-auth-settings.rst b/source/includes/nav/steps-auth-settings.rst
@@ -0,0 +1,13 @@
+.. step:: Go to the :guilabel:`Authentication Settings` view.
+
+    .. note::
+
+       You must be a :ref:`Project Owner <dashboard-permissions>` to
+       access the :guilabel:`Authentication Settings` page. As a 
+       non-admin user, you can still use embedded charts, but you 
+       must get a key from a Project Owner.
+      
+    Click the :guilabel:`Authentication Settings` tab.
+
+    The `Authentication Settings <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fembedding%2Fauthentication-settings>`__
+    tab displays.
diff --git a/source/includes/nav/steps-data-sources.rst b/source/includes/nav/steps-data-sources.rst
@@ -2,3 +2,5 @@
 
    Click :guilabel:`Data sources` under the 
    :guilabel:`Deployments` heading in the sidebar.
+
+   The `Data Sources <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fdata-sources>`__ page displays.
diff --git a/source/includes/nav/steps-data-transfer.rst b/source/includes/nav/steps-data-transfer.rst
@@ -2,4 +2,6 @@
 
    Click :guilabel:`Data transfer` under the 
    :guilabel:`Usage` heading in the sidebar.
+   
+   The `Data Transfer <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fdata-transfer>`__ page displays.
    
diff --git a/source/includes/nav/steps-embedding.rst b/source/includes/nav/steps-embedding.rst
@@ -2,3 +2,5 @@
 
    Click :guilabel:`Embedding` under the 
    :guilabel:`Development` heading in the sidebar.
+
+   The `Embedding <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fembedding%2Fgetting-started>`__ page displays.
diff --git a/source/includes/nav/steps-ingestions.rst b/source/includes/nav/steps-ingestions.rst
@@ -2,3 +2,6 @@
 
    Click :guilabel:`Ingestions` under the 
    :guilabel:`Deployments` heading in the sidebar.
+
+   The `Ingestions <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fingestions>`__ page displays.
+   
diff --git a/source/includes/nav/steps-organization-dashboards.rst b/source/includes/nav/steps-organization-dashboards.rst
@@ -1,5 +1,7 @@
-.. step:: Go to the :guilabel:`Dashboards` page for your organization.
+.. step:: Go to the :guilabel:`Organization Dashboards` page.
 
-   If the :guilabel:`Dashboards` page for your organization isn't 
+   If the :guilabel:`Organization Dashboards` page isn't 
    already displayed, click :guilabel:`Organization` under the 
    :guilabel:`Dashboards` heading in the sidebar.
+
+   The `Organization Dashboards <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Forganization-overview>`__ page displays.
diff --git a/source/includes/nav/steps-owners.rst b/source/includes/nav/steps-owners.rst
@@ -0,0 +1,7 @@
+.. step:: Go to the :guilabel:`Owners` page for your project.
+
+   If the :guilabel:`Owners` page isn't 
+   already displayed, click :guilabel:`Owners` under the 
+   :guilabel:`Dashboards` heading in the sidebar.
+
+   The `Owners <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fowners>`__ page displays.
diff --git a/source/includes/nav/steps-project-dashboards.rst b/source/includes/nav/steps-project-dashboards.rst
@@ -3,3 +3,6 @@
    If the :guilabel:`Dashboards` page for your project isn't already 
    displayed, click :guilabel:`Project` under the 
    :guilabel:`Dashboards` heading in the sidebar.
+
+   The `Dashboards <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fdashboards>`__ page for your 
+   project displays.
diff --git a/source/includes/nav/steps-reports.rst b/source/includes/nav/steps-reports.rst
@@ -2,3 +2,5 @@
 
    Click :guilabel:`Reports` under the 
    :guilabel:`Scheduling` heading in the sidebar.
+
+   The `Reports <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Freports>`__ page displays.
diff --git a/source/includes/nav/steps.rst b/source/includes/nav/steps.rst
diff --git a/source/includes/steps-add-auth-google-tutorial.rst b/source/includes/steps-add-auth-google-tutorial.rst
@@ -5,9 +5,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: Add the authentication provider.
       
diff --git a/source/includes/steps-add-auth-jwt-tutorial.rst b/source/includes/steps-add-auth-jwt-tutorial.rst
@@ -5,9 +5,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: Add the authentication provider.
       
diff --git a/source/includes/steps-add-auth-providers.rst b/source/includes/steps-add-auth-providers.rst
@@ -5,9 +5,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: Add the authentication provider.
       
diff --git a/source/includes/steps-add-auth-stitch-tutorial.rst b/source/includes/steps-add-auth-stitch-tutorial.rst
@@ -5,9 +5,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: Add the authentication provider.
       
diff --git a/source/includes/steps-delete-auth-providers.rst b/source/includes/steps-delete-auth-providers.rst
@@ -5,9 +5,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: Delete the embedding provider.
       
diff --git a/source/includes/steps-edit-auth-providers.rst b/source/includes/steps-edit-auth-providers.rst
@@ -5,9 +5,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: Edit the embedding provider.
       
diff --git a/source/includes/steps-enable-embedding-iframe-verified.rst b/source/includes/steps-enable-embedding-iframe-verified.rst
@@ -38,16 +38,7 @@
 
    .. include:: /includes/nav/steps-embedding.rst
 
-   .. step:: Acquire an embedding key.
-
-      Click the :guilabel:`Authentication Settings` tab.
-
-      .. note::
-
-         You must be a :ref:`Project Owner <dashboard-permissions>` to
-         access the :guilabel:`Authentication Settings` page. As a 
-         non-admin user, you can still use embedded charts, but you 
-         must get a key from a Project Owner.
+   .. include:: /includes/nav/steps-auth-settings.rst
 
    .. step:: Generate an embedding key.
 
diff --git a/source/includes/steps-view-auth-providers.rst b/source/includes/steps-view-auth-providers.rst
@@ -5,8 +5,6 @@
 
    .. include:: /includes/nav/steps-embedding.rst
       
-   .. step:: Go to the :guilabel:`Authentication Settings` view.
-      
-      Click the :guilabel:`Authentication Settings` tab.
+   .. include:: /includes/nav/steps-auth-settings.rst
       
    .. step:: View the configured authentication providers in the :guilabel:`Authentication providers` section.
diff --git a/source/manage-embedded-items.txt b/source/manage-embedded-items.txt
@@ -47,6 +47,9 @@ View Embedded Items
 
       Click the :guilabel:`Items` tab.
 
+      The `Items <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fembedding%2Fitems>`__ tab 
+      displays.
+
    .. step:: (Optional) Filter the list of embedded items.
 
       Do one or all of the following steps:
@@ -68,6 +71,9 @@ Modify an Embedded Item
 
       Click the :guilabel:`Items` tab.
 
+      The `Items <https://cloud.mongodb.com/go?l=https%3A%2F%2Fcharts.mongodb.com%2F%3Cchart-app-id%3E%2Fembedding%2Fitems>`__ tab 
+      displays.
+
    .. step:: Go to the embedding settings.
 
       Click :guilabel:`Settings` next to the embedded item that you 
