(DOCSP-32020) Adds procedure to query documents with Atlas (#4823) (#4963)

Author: sarahsimpers

source/tutorial/query-documents.txt

@@ -19,14 +19,14 @@ Query Documents
    :backlinks: none
    :depth: 1
 
-----------
+You can query documents in MongoDB by using the following
+methods:
 
-.. |arrow| unicode:: U+27A4
+.. |atlas-ref| replace:: :ref:`query-documents-atlas-ui`
 
-|arrow| Use the **Select your language** drop-down menu in the
-upper-right to set the language of the following examples.
+.. include:: /includes/fact-methods.rst
 
-----------
+.. include:: /includes/language-selector-instructions.rst
 
 .. tabs-selector:: drivers
 
@@ -251,6 +251,40 @@ which corresponds to the following SQL statement:
    MongoDB supports regular expressions :query:`$regex` queries to
    perform string pattern matches.
 
+.. _query-documents-atlas-ui:
+
+Query Documents with {+atlas+}
+------------------------------------------
+
+The example in this section uses the :atlas:`sample movies dataset 
+</sample-data/sample-mflix/>`. To learn how to load the sample dataset 
+into your {+atlas+} deployment, see :atlas:`Load Sample Data 
+</sample-data/#std-label-load-sample-data>`.
+
+To project fields to return from a query in {+atlas+}, follow these
+steps:
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: Navigate to the collection
+
+      .. include:: /includes/steps-nav-atlas-sample-movies.rst
+
+   .. step:: Specify the :guilabel:`Filter` field
+
+      .. include:: /includes/steps-specify-query-filter.rst
+
+      .. code-block:: javascript
+
+         { year: 1924 }
+
+   .. step:: Click :guilabel:`Apply`
+
+      This query filter returns all documents
+      in the ``sample_mflix.movies`` collection where the ``year``
+      field matches ``1924``.
+
 Additional Query Tutorials
 --------------------------
 
@@ -383,15 +417,15 @@ To learn how to iterate through documents in a cursor, refer to your
 :driver:`driver's documentation </>`. If you are using ``mongosh``, see
 :ref:`read-operations-cursors`.
 
+Additional Methods and Options
+------------------------------
+
 .. tabs-drivers::
 
    tabs:
      - id: shell
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :method:`db.collection.findOne`
@@ -409,9 +443,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: compass
        content: |
 
-         Additional Options
-         ------------------
-
          In addition to ``filter``, MongoDB Compass also allows the
          following options to be passed to the query bar:
 
@@ -437,9 +468,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: python
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :py:meth:`pymongo.collection.Collection.find_one`
@@ -459,9 +487,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: java-sync
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - In the :doc:`aggregation pipeline </core/aggregation-pipeline>`,
@@ -472,9 +497,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: java-async
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - In :doc:`aggregation pipeline </core/aggregation-pipeline>`,
@@ -486,9 +508,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: nodejs
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :node-api:`Collection.findOne() <Collection.html#findOne>`
@@ -510,9 +529,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: php
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :phpmethod:`MongoDB\\Collection::findOne() <phpmethod.MongoDB\\Collection::findOne>`
@@ -534,9 +550,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: perl
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :perl-api:`MongoDB::Collection::find_one()<Collection#find_one>`
@@ -558,9 +571,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: ruby
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - In :doc:`aggregation pipeline </core/aggregation-pipeline>`, the
@@ -571,9 +581,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: scala
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - In :doc:`aggregation pipeline </core/aggregation-pipeline>`, the
@@ -583,9 +590,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: csharp
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :csharp-api:`MongoCollection.FindOne() <M_MongoDB_Driver_MongoCollection_1_FindOne_1>`
@@ -607,9 +611,6 @@ To learn how to iterate through documents in a cursor, refer to your
      - id: go
        content: |
 
-         Additional Methods
-         ------------------
-
          The following methods can also read documents from a collection:
 
          - :go-api:`Collection.FindOne <mongo#Collection.FindOne>`