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

Author: sarahsimpers

source/tutorial/query-documents.txt

@@ -23,14 +23,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
 
@@ -255,6 +255,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
 --------------------------
 
@@ -385,15 +419,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`
@@ -411,9 +445,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:
 
@@ -439,9 +470,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`
@@ -461,9 +489,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 :ref:`aggregation pipeline <aggregation-pipeline>`,
@@ -474,9 +499,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 :ref:`aggregation pipeline <aggregation-pipeline>`,
@@ -488,9 +510,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>`
@@ -512,9 +531,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>`
@@ -536,9 +552,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>`
@@ -560,9 +573,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 :ref:`aggregation pipeline <aggregation-pipeline>`, the
@@ -573,9 +583,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 :ref:`aggregation pipeline <aggregation-pipeline>`, the
@@ -585,9 +592,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>`
@@ -609,9 +613,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>`