DOCSP-13277 Entry points for overview page

kanchana-mongodb · kanchana-mongodb · commit 58aa1905865e · 2020-12-08T12:03:25.000-08:00
diff --git a/source/connect.txt b/source/connect.txt
@@ -18,15 +18,18 @@ This page outlines how to use |vsce| to connect to a
 MongoDB host. You can connect to a standalone, replica set,
 or sharded cluster host.
 
-.. admonition:: MongoDB Atlas
-   :class: note
+.. note:: MongoDB Atlas
 
    If you need to create a MongoDB host, consider using 
    `MongoDB Atlas <https://www.mongodb.com/cloud/atlas?tck=docs_vsce>`__.
-   Atlas is a cloud-hosted database-as-a-service which requires no 
+   |service| is a cloud-hosted database-as-a-service which requires no 
    installation, offers a free tier to get started, and provides a 
    copyable URI to easily connect |vsce| to your deployment.
 
+   To create a cluster on the |service| free tier, run the command 
+   ``MongoDB: Open Overview Page`` in the |vscode-short| Command 
+   Palette and then click :guilabel:`Create free cluster`.
+
    To create an |service| cluster using a Terraform template included
    with |vsce|, see :ref:`vsce-create-cluster-terraform`.
 
diff --git a/source/includes/steps-starting-vsce-individual-fields.yaml b/source/includes/steps-starting-vsce-individual-fields.yaml
@@ -4,16 +4,42 @@ source:
   file: steps-open-mongodb-view.yaml
   ref: open-mongodb-view
 ---
-title: Create a connection to a deployment.
+title: Open the |vsce| *Overview* page from the Command Palette or from 
+       the :guilabel:`MongoDB` view in the :guilabel:`Activity Bar` .
 level: 4
 ref: create-connection
 content: |
 
-  a. Click the :guilabel:`Plus` icon.
+  .. tabs:: 
 
-  #. Expand the :guilabel:`More Actions` menu (:guilabel:`...`), then 
-     click :guilabel:`Add MongoDB Connection`.
+     .. tab:: Open from Command Palette 
+        :tabid: mdboverview
 
+        a. Perform the action described in the following table for your 
+           operating system and method:
+
+           .. include:: /includes/list-tables/command-palette-options.rst
+        
+        #. From the Command Palette, select :guilabel:`MongoDB: Open 
+           Overview Page`.
+
+           .. include:: /includes/admonitions/tip-mongodb-command-palette.rst
+
+     .. tab:: Open from MongoDB View 
+        :tabid: mdbview 
+
+        a. Expand the :guilabel:`Connections` pane in the left 
+           navigation if it's collapsed.
+
+        #. Click the :guilabel:`More Actions` menu (:guilabel:`...`), 
+           then click :guilabel:`Add MongoDB Connection` to open the 
+           |vsce| *Overview* page.
+
+---
+title: In the *Overview* page, click :guilabel:`Open form` under 
+       :guilabel:`Advanced Connection Settings` to create a connection to a deployment.
+level: 4
+ref: vsce-advanced-connection-settings
 ---
 title: Enter your connection information.
 ref: vsce-enter-connection-info
@@ -28,7 +54,7 @@ content: |
      For more information, see the **Paste Connection String** tab in 
      :ref:`vsce-connect-task`.
 
-  The :guilabel:`Hostname` dialog contains the following connection
+  The :guilabel:`General` tab contains the following connection
   field options:
 
   .. list-table:: 
@@ -174,61 +200,6 @@ content: |
                     For example, the username "X509User" must be 
                     provided as "CN=X509User".
 
----
-title: "Specify replica set and security connection options."
-level: 4
-optional: true
-ref: connect-additional-options
-content: |
-  You can specify the following security connection options:
-
-  .. list-table::
-     :header-rows: 1
-
-     * - Option
-       - Description
-
-     * - :guilabel:`Replica Set Name`
-       - If your MongoDB deployment is a replica set, specify the
-         replica set name. Not required if you specify your replica
-         set :guilabel:`Hostname` as an :guilabel:`SRV Record`.
-
-     * - :guilabel:`Read Preference`
-       - Specifies how |vsce| directs read operations. Options are:
-
-         .. list-table::
-            :header-rows: 1
-            :widths: 20 50
-
-            * - Read Preference Mode
-              - Description
-
-            * - ``primary``
-              - Default mode. All operations read from the current 
-                replica set primary.
-
-            * - ``primaryPreferred``
-              - In most situations, operations read from the primary but
-                if it is unavailable, operations read from secondary
-                members.
-
-            * - ``secondary``
-              - All operations read from the secondary members of the
-                replica set.
-
-            * - ``secondaryPreferred``
-              - In most situations, operations read from secondary
-                members but if no secondary members are available,
-                operations read from the primary.
-
-            * - ``nearest``
-              - Operations read from member of the replica
-                set with the least network latency, irrespective of the 
-                member's type.
-         
-         To learn more about read preferences, see
-         :manual:`Read Preference </core/read-preference/>`.
-
   If you are connecting to your deployment using TLS/SSL or an SSH
   tunnel, refer to the following tabs for specific instructions:
   
@@ -411,6 +382,61 @@ content: |
            tunnel. |vsce| cannot establish a connection
            to multiple servers across the same SSH tunnel.
 ---
+title: "Specify replica set and security connection options."
+level: 4
+optional: true
+ref: connect-additional-options
+content: |
+  You can specify the following security connection options:
+
+  .. list-table::
+     :header-rows: 1
+
+     * - Option
+       - Description
+
+     * - :guilabel:`Replica Set Name`
+       - If your MongoDB deployment is a replica set, specify the
+         replica set name. Not required if you specify your replica
+         set :guilabel:`Hostname` as an :guilabel:`SRV Record`.
+
+     * - :guilabel:`Read Preference`
+       - Specifies how |vsce| directs read operations. Options are:
+
+         .. list-table::
+            :header-rows: 1
+            :widths: 20 50
+
+            * - Read Preference Mode
+              - Description
+
+            * - ``primary``
+              - Default mode. All operations read from the current 
+                replica set primary.
+
+            * - ``primaryPreferred``
+              - In most situations, operations read from the primary but
+                if it is unavailable, operations read from secondary
+                members.
+
+            * - ``secondary``
+              - All operations read from the secondary members of the
+                replica set.
+
+            * - ``secondaryPreferred``
+              - In most situations, operations read from secondary
+                members but if no secondary members are available,
+                operations read from the primary.
+
+            * - ``nearest``
+              - Operations read from member of the replica
+                set with the least network latency, irrespective of the 
+                member's type.
+         
+         To learn more about read preferences, see
+         :manual:`Read Preference </core/read-preference/>`.
+
+---
 ref: vsce-click-connect
 level: 4
 title: "Click :guilabel:`Connect`."
diff --git a/source/includes/steps-starting-vsce-paste-string.yaml b/source/includes/steps-starting-vsce-paste-string.yaml
@@ -24,21 +24,61 @@ content: |
     :manual:`Connection String URI Format
     </reference/connection-string>`.
 ---
-source:
-  file: steps-source-command-palette.yaml
-  ref: vsce-command-palette
-ref: vsce-connect-command-palette
----
-title: "From the Command Palette, select 
-      :guilabel:`MongoDB: Connect with Connection String...`."
+title: "In |vscode-short|, open the Command Palette from the |vsce| 
+       *Overview* page, from the :guilabel:`MongoDB` view in the 
+       :guilabel:`Activity Bar`, or directly to paste the connection 
+       string."
 level: 4
-ref: vsce-connect-connect
-content: |
+ref: vsce-open-overview-page
+content: | 
 
-  .. include:: /includes/admonitions/tip-mongodb-command-palette.rst
+  .. tabs:: 
 
----
+     .. tab:: Open from Overview Page 
+        :tabid: mdboverview
+
+        a. Perform the action described in the following table for your 
+           operating system and method:
+
+           .. include:: /includes/list-tables/command-palette-options.rst
+        
+        #. From the Command Palette, select :guilabel:`MongoDB: Open 
+           Overview Page`.
+
+           .. include:: /includes/admonitions/tip-mongodb-command-palette.rst
+
+        #. In the *Overview* page, click :guilabel:`Connect` under the 
+           :guilabel:`Connect with Connection String`.
 
+     .. tab:: Open from MongoDB View
+        :tabid: mdbview 
+
+        a. Expand the :guilabel:`Connections` pane in the left 
+           navigation if it is collapsed.
+           
+        #. Click the :guilabel:`More Actions` menu (:guilabel:`...`), 
+           then click one of following to open the Command Palette: 
+           
+           - :guilabel:`Add MongoDB Connection`, then 
+             :guilabel:`Connect` under the :guilabel:`Connect with 
+             Connection String` in the *Overview* page.
+           - :guilabel:`Add MongoDB Connection with Connection 
+             String...`.
+
+     .. tab:: Open Directly 
+        :tabid: cmdpalette
+
+        a. Perform the action described in the following table for your 
+           operating system and method:
+
+           .. include:: /includes/list-tables/command-palette-options.rst
+        
+        #. From the Command Palette, select :guilabel:`MongoDB: Connect 
+           with Connection String...`.
+
+           .. include:: /includes/admonitions/tip-mongodb-command-palette.rst
+  
+---
 title: "Paste your connection string into the Command Palette."
 level: 4
 ref: vsce-connect-paste
diff --git a/source/playgrounds.txt b/source/playgrounds.txt
@@ -53,8 +53,8 @@ Open a Playground
 Create a New Playground
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-You can create a new playground from either the :guilabel:`Playgrounds`
-panel, or the |vscode| Command Pallette.
+You can create a new playground from the :guilabel:`Playgrounds`
+panel, the |vsce| *Overview* page, or the |vscode| Command Pallette.
 
 .. tabs::
 
@@ -73,6 +73,25 @@ panel, or the |vscode| Command Pallette.
       the :guilabel:`...` menu icon of the :guilabel:`Playgrounds` panel
       and select :guilabel:`Create MongoDB Playground`.
 
+   .. tab:: Overview Page 
+      :tabid: mdboverview
+
+      1. In |vscode-short|, press one of the following key combinations:
+
+         - :guilabel:`Control + Shift + P` on Windows or Linux.
+         - :guilabel:`Command + Shift + P` on macOS.
+
+         The :guilabel:`Command Palette` provides quick access to 
+         commands and keyboard shortcuts.
+        
+      #. Find and run the :guilabel:`MongoDB: Open Overview Page` 
+         command.
+
+         .. include:: /includes/admonitions/tip-mongodb-command-palette.rst
+
+      #. Click :guilabel:`Create Playground` to open a |vsce| 
+         playground pre-configured with a few commands.
+
    .. tab:: VSCode Command Palette
       :tabid: command-palette
 
