(DOCSP-32295) Adds Atlas-centric info to manual landing page (#4739) (#4864)

* (DOCSP-32295) Adds Atlas-centric info to manual landing page

* Cleans up links and format

* Includes tech review changes

* Splits out connect step and removes import on first tab

* Changes mongosh command line example to atlas setup and adds link

* Includes copy and tech review changes

* Adds MongoDB manual location for links within these docs

Author: sarahsimpers

source/aggregation.txt

@@ -1,3 +1,5 @@
+.. _aggregation:
+
 ======================
 Aggregation Operations
 ======================

source/index.txt

@@ -11,15 +11,9 @@ What is MongoDB?
    MongoDB is a document database designed for ease of application
    development and scaling.
 
-   Run MongoDB with
+   You can run MongoDB in the following environments:
 
-   - `MongoDB Atlas
-     <https://www.mongodb.com/cloud?tck=docs_server>`__ fully managed in
-     the cloud,
-   - the source available and free-to-use :ref:`MongoDB
-     Community <install-mdb-community-edition>`, or
-   - the :ref:`MongoDB Enterprise Advanced
-     <install-mdb-enterprise>` subscription.
+   .. include:: /includes/fact-environments.rst
 
    .. button:: Install MongoDB
       :uri: /installation
@@ -41,47 +35,57 @@ Work with your data in MongoDB
 
       .. procedure::
 
-         .. step:: Model your data
-
-            Design your data schema to support frequent access patterns.
-            You can update or enforce your schema at any point.
-
-            :doc:`To learn more, see Data Modeling Introduction </core/data-modeling-introduction>`
+         .. step:: Deploy MongoDB
+
+            Create a cluster in the {+atlas+} UI or the Atlas CLI
+            quickly and easily. To learn more, see 
+            :atlas:`Create a Cluster </tutorial/create-new-cluster>` 
+            in the {+atlas+} documentation
+            and :atlascli:`Get Started with Atlas </atlas-cli-getting-started>` in the Atlas CLI documentation. 
+            
+            For self-hosted deployments,
+            see :ref:`Replication <replication>` in the MongoDB manual
+            to create a replica
+            set.
+            
+         .. step:: Connect to your deployment
+
+            Access deployments in the 
+            {+atlas+} UI or connect with :driver:`drivers </>` or the
+            :mongosh:`MongoDB Shell (mongosh) </>` in the MongoDB
+            manual. 
+            
+            To learn more, see :ref:`Find Your Connection String <find-connection-string>` in the MongoDB manual.
 
-         .. step:: Connect to MongoDB
+         .. step:: Insert, query, update, or delete documents
 
-            Import data from CSV or JSON files into your MongoDB
-            database.
+            Perform CRUD operations in the {+atlas+} UI or by using the
+            MongoDB Query API - with or without transactions.
 
-            :mongosh:`To learn more, see MongoDB Shell (mongosh) </>`
+            To learn more, see 
+            :atlas:`Create, View, Update, and Delete Documents 
+            </atlas-ui/documents/>` in the {+atlas+} documentation and
+            :ref:`MongoDB CRUD Operations <crud>` in the MongoDB manual.
 
-         .. step:: Insert, query, update, or delete documents
+         .. step:: Model your data
 
-            Use the MongoDB Query API to perform CRUD operations on your
-            data - with or without transactions.
+            Design your data schema to support frequent access patterns.
+            You can update or enforce your schema at any point.
 
-            :ref:`To learn more, see MongoDB CRUD Operations <crud>`
+            To learn more, see :ref:`Data Modeling Introduction 
+            <manual-data-modeling-intro>` in the MongoDB manual.
 
       .. code-block:: javascript
 
-         ➜ mongosh --port 27017
-         Current Mongosh Log ID:  123a4bc5d67891011ef1213g
-         Connecting to:    mongodb://127.0.0.1:27017/
-
-         For mongosh info see: https://www.mongodb.com/docs/mongodb-shell/
-
-         test> db.messages.insertMany([
-                  {
-                     message: "Hello World!",
-                     author: "MongoDB",
-                     comments: [],
-                     _id: 1
-                  }
-               ])
-         { acknowledged: true, insertedIds: { '0': 1 } }
+         ➜ atlas setup
+         ? Do you want to setup your Atlas database with default settings? (Y/n)
+         ➜ Y
 
-         test> db.messages.findOne({ _id: 1 })
-         { _id: 1, message: 'Hello World!', author: 'MongoDB', comments: [] }
+         We are deploying Cluster9876543...
+         Please store your database authentication access details in a secure location.
+         Database User Username: Cluster9876543
+         Database User Password: abcdef12345
+         Creating your cluster... [Its safe to 'Ctrl + C']
 
    .. tab:: Transform data with Aggregations
       :tabid: transform
@@ -90,15 +94,23 @@ Work with your data in MongoDB
 
          .. step:: Import your data
 
-            Import data from a CSV or JSON file with mongoimport.
+            Import data from a CSV or JSON file with database tools.
 
-            `To learn more, see mongoimport <https://www.mongodb.com/docs/database-tools/mongoimport/>`__
+            To learn more, see 
+            :atlas:`Migrate or Import Data </import>` in the {+atlas+}
+            documentation and `mongoimport 
+            <https://www.mongodb.com/docs/database-tools/mongoimport/>`__ in the database tools documentation.
 
          .. step:: Aggregate your data
 
-            Use aggregation pipelines to process your data in multiple stages and return the computed results.
+            Use aggregation pipelines to process your data in multiple
+            stages and return the computed results. You can  
+            preview the results at each pipeline stage when you 
+            run aggregation pipelines in {+atlas+}.
 
-            :doc:`To learn more, see Aggregation </aggregation>`
+            To learn more, see :atlas:`Run Aggregation Pipelines
+            </atlas-ui/agg-pipeline>` in the {+atlas+} documentation
+            and :ref:`aggregation` in the MongoDB manual.
 
       .. code-block:: javascript
 
@@ -134,14 +146,20 @@ Work with your data in MongoDB
             Verify the identity of a user, replica set member, or
             sharded cluster member with authentication.
 
-            :ref:`To learn more, see Authentication <authentication>`
+            To learn more, see :atlas:`Atlas UI Authenication 
+            </atlas-ui-authentication>` in the {+atlas+} documentation
+            and :ref:`Authentication <authentication>` in the MongoDB
+            manual.
 
          .. step:: Control access to your database
 
             Enable Role-Based Access Controls to manage user privileges
             on your entire database cluster or individual collections.
 
-            :ref:`To learn more, see Role-Based Access Controls <authorization>`
+            To learn more, see :atlas:`Atlas UI Authorization 
+            </atlas-ui-authorization>` in the {+atlas+} documentation
+            and :ref:`Role-Based Access Controls <authorization>`
+            in the MongoDB manual.
 
          .. step:: Encrypt your most sensitive data
 
@@ -151,7 +169,7 @@ Work with your data in MongoDB
             memory and at rest.
 
             To learn more, see :ref:`Client-Side Field Level Encryption
-            <manual-csfle-feature>`.
+            <manual-csfle-feature>` in the MongoDB manual.
 
       .. image:: /images/security.png
          :alt: MongoDB Security
@@ -161,17 +179,29 @@ Work with your data in MongoDB
 
       .. procedure::
 
-         .. step:: Deploy a replica set
+         .. step:: Create a deployment
 
-            Provide redundancy and resilience for your database by deploying a replica set.
+            Create a free cluster, an auto-scaling cluster, or a
+            serverless instance in the {+atlas+} UI. To learn
+            more, see 
+            :atlas:`Choose a Database Deployment Type 
+            </create-database-deployment/#std-label-ref-deployment-types>` in the {+atlas+}
+            documentation.
 
-            :ref:`To learn more, see Replication <replication>`
+            For self-hosted deployments, provide redundancy and
+            resilience for your database by deploying a replica set. To
+            learn more, see :ref:`Replication <replication>` in the
+            MongoDB manual.
 
          .. step:: Scale out your database
 
-            Use sharding to horizontally scale your database or to ensure location-based separation of data.
+            Use sharding to horizontally scale your database or to
+            ensure location-based separation of data.
 
-            :ref:`To learn more, see Sharding <sharding-introduction>`
+            To learn more, see :atlas:`Shard a Collection 
+            </collections/#shard-a-collection>` in the {+atlas+}
+            documentation and :ref:`Sharding <sharding-introduction>`
+            in the MongoDB manual.
 
       .. image:: /images/scaling.png
          :alt: MongoDB Deploy and Scale

source/reference/connection-string.txt

@@ -39,6 +39,8 @@ Compatibility
 
 .. include:: /includes/fact-compatibility-standard-page.rst
 
+.. _find-connection-string:
+
 Find Your Connection String
 ---------------------------