(DOCSP-32029): Add procedure to connect to an Atlas deployment (#300)

* Add procedure to connect to an Atlas deployment

* Editing pass to improve readability

* Remove distracting bin link

* Incorporate review feedback

* What does it look like if I use monospace in the section header?

* Remove Install info from Learn More

* Apply suggestions from review

Co-authored-by: Alison Huh <[email protected]>

* Change the Learn More step to a note

---------

Co-authored-by: Alison Huh <[email protected]>

Author: dacharyc

source/connect.txt

@@ -13,13 +13,75 @@ Connect to a Deployment
    :class: singlecol
 
 This page shows how to use the |mdb-shell| to connect to a MongoDB
-deployment.
+deployment. You can connect to a 
+`MongoDB Atlas cloud-hosted deployment <https://www.mongodb.com/docs/atlas>`__,
+connect to a local deployment, or connect to another remote host with
+|mdb-shell|.
 
 Prerequisites
 -------------
 
 .. include:: /includes/fact-connect-prereqs.rst
-   
+
+Install ``mongosh``
+~~~~~~~~~~~~~~~~~~~
+
+These procedures assume you have already installed ``mongosh``. For more 
+information about installing ``mongosh``, refer to 
+:ref:`mdb-shell-install`.
+
+Connect to a MongoDB Atlas Deployment
+-------------------------------------
+
+You can connect to your MongoDB Atlas deployment directly from your shell.
+
+.. procedure::
+   :style: normal
+
+   .. step:: Get your Atlas Connection String
+
+      You need an Atlas connection string to connect from |mdb-shell|.
+      You can get the Atlas connection string in the Atlas UI.
+
+      Refer to the
+      `Find Your MongoDB Atlas Connection String 
+      <https://www.mongodb.com/docs/manual/reference/connection-string/#find-your-mongodb-atlas-connection-string>`__ 
+      guide for details.
+
+   .. step:: Set Your Database Credentials
+
+      If you haven't already 
+      `created a database user 
+      <https://www.mongodb.com/docs/atlas/tutorial/create-mongodb-user-for-cluster/>`__, 
+      you must set a username and password. To connect to Atlas, pass your username with the connection string.
+      the connection string to connect to Atlas. After you issue the 
+      connect command, the shell prompts for your password.
+
+   .. step:: Connect to MongoDB Atlas with ``mongosh``
+
+      To establish your connection, run the ``mongosh`` command with your connection string and options
+      to establish the connection.
+
+      The connection string includes the following elements:
+
+      - Your cluster name
+      - A hash
+      - A flag for the API version
+      - A flag for the username you want to use to connect
+
+      It resembles the following string:
+
+      .. code-block:: sh
+
+         mongosh "mongodb+srv://YOUR_CLUSTER_NAME.YOUR_HASH.mongodb.net/" --apiVersion YOUR_API_VERSION --username YOUR_USERNAME
+
+.. note:: Learn More
+
+   You can use other connection security options to connect to Atlas via
+   ``mongosh``. For information on connecting with a private 
+   IP for peering or a Private Endpoint connection, refer to the 
+   `Atlas Connect via mongosh <https://www.mongodb.com/docs/atlas/mongo-shell-connection/#choose-your-connection-security>`__ 
+   documentation.
 
 Connect to a Local Deployment on the Default Port
 -------------------------------------------------