DOCSP-2477:add language to clarify URIWriter

Author: skerschb

source/includes/drivers_connect.rst

@@ -44,18 +44,18 @@
      - id: compass
        content: |
 
-         MongoDB Compass can detect whether you have a MongoDB URI
-         connection string in your system clipboard and auto-populate
-         the connection dialog from the URI.
-
-         First, copy the URI string below.
-
-         .. code-block:: sh
-
-            <URISTRING>
-
-         Now start Compass. Compass will be able to access the URI and
-         use it for the connection.
+         If you wish to manually configure your Compass connection, load
+         Compass and select the ``New Connection`` link. You will see a
+         form where you can enter connection information for MongoDB.
+
+         Atlas users can copy a URI string from the Atlas
+         console into Compass. MongoDB Compass can detect whether you have a MongoDB
+         URI connection string in your system clipboard and auto-
+         populate the connection dialog from the URI.
+
+         See :doc:`/guides/cloud/connectionstring` for information on
+         how to get the Atlas connection string URI into your copy
+         buffer.
 
          If Compass was already running when you copied the URI string,
          click the :guilabel:`NEW CONNECTION` button.

source/includes/steps-drivers_install_gs.yaml

@@ -7,7 +7,7 @@ content: |
   .. include:: /includes/drivers_install.rst
 
 ---
-title: Create the MongoDB Connection URI String
+title: Get the MongoDB Connection URI String
 ref: connection_string
 level: 4
 stepnum: 2
@@ -18,14 +18,37 @@ content: |
   supplied as a parameter to the ``mongo`` shell, Compass, and the
   MongoDB drivers to connect to a MongoDB
   deployment.
+
+  Atlas users can retrieve their URI strings from the Atlas web console.
+  For information on how to do that, please see the
+  :doc:`/guides/cloud/connectionstring` guide.
+
+  .. note::
+
+     The URI form below allows you to create a URI string for your
+     session in MongoDB Guides  -- from either the connection string
+     that Atlas provides, or by filling out the form for on-premises
+     MongoDB instances. Once you provide the string or fill out the
+     form, any relevant code examples within the MongoDB Guides will be
+     populated with a URI string. You can change these at any time by
+     repopulating the form.
   
-  Use the form below to populate the URI string.
+  Use the fields below to create your URI string in MongoDB Guides and
+  populate the code examples. 
+
+  .. tip::
+     
+     Users of Compass should skip this step and load Compass directly
+     with the URI String in the copy buffer (for Atlas), or by
+     populating the ``New Connection`` form in Compass.
 
-  .. note:: The $[password] will not be replaced in the string below, so you will 
-            need to replace the string with your password.
-            Use caution where you store and enter passwords, particularly when
-            running from a shell or command prompt. Special characters
-            in passwords must be escaped.
+  .. warning::
+     
+     The $[password] will not be replaced in the string below, so you
+     will need to replace the string with your password. Use caution
+     where you store and enter passwords, particularly when running from
+     a shell or command prompt. Special characters in passwords must be
+     escaped.
   
   .. uriwriter::
 ---

source/includes/steps-insert_server.yaml

@@ -4,9 +4,7 @@ level: 4
 stepnum: 1
 content: |
 
-  If you haven't already done so, use :doc:`the connection URI form
-  </guides/server/drivers>` to construct the connection string
-  required for this guide.
+  If you haven't already done so, non-Compass users may use :doc:`the connection URI form </guides/server/drivers>` to construct the connection string required. 
 
   .. include:: /includes/drivers_connect.rst
 ---

source/includes/steps-read_operators.yaml

@@ -4,7 +4,7 @@ level: 4
 stepnum: 1
 content: |
 
-  If you haven't already done so, use `the connection URI form <https://docs-mongodbcom-staging.corp.mongodb.com/docs-tutorials/skersch/Guides/guides/server/drivers.html#craft-a-uri-to-connect-to-mongodb>`__ to construct the connection string required.
+  If you haven't already done so, non-Compass users may use :doc:`the connection URI form </guides/server/drivers>` to construct the connection string required. 
 
 
   .. include:: /includes/drivers_connect.rst

source/includes/steps-read_server.yaml

@@ -4,7 +4,7 @@ level: 4
 stepnum: 1
 content: |
 
-  If you haven't already done so, use :doc:`the connection URI form </guides/server/drivers>` to construct the connection string required.
+  If you haven't already done so, non-Compass users may use :doc:`the connection URI form </guides/server/drivers>` to construct the connection string required. 
 
 
   .. include:: /includes/drivers_connect.rst

source/includes/steps-read_server_query.yaml

@@ -4,7 +4,7 @@ level: 4
 stepnum: 1
 content: |
 
-  If you haven't already done so, use :doc:`the connection URI form </guides/server/drivers>` to construct the connection string required.
+  If you haven't already done so, non-Compass users may use :doc:`the connection URI form </guides/server/drivers>` to construct the connection string required. 
 
   .. include:: /includes/drivers_connect.rst
 ---