(DOCSP-32021)(DOCSP-33353) Adds procedure to query embedded docs in Atlas and updates selector instructions (#4821) (#4877)

* (DOCSP-32021)(DOCSP-33353) Adds procedure to query embedded docs in Atlas and updates selector instructions

* Adds some includes to use in other PRs

* Includes changes from copy and tech review

* Includes copy review fix to format

Author: sarahsimpers

source/includes/fact-methods.rst

@@ -0,0 +1,4 @@
+- Your programming language's driver.
+- The :atlas:`{+atlas+} UI </>`. To learn more, see 
+  |atlas-ref|.
+- :compass:`MongoDB Compass </>`.

source/includes/language-selector-instructions.rst

@@ -0,0 +1,9 @@
+----------
+
+.. |arrow| unicode:: U+27A4
+
+|arrow| Use the **Select your language** drop-down menu in the
+upper-right to set the language of the following examples or select
+MongoDB Compass.
+
+----------

source/includes/steps-nav-atlas-sample-movies.rst

@@ -0,0 +1,6 @@
+a. In the {+atlas+} UI, click :guilabel:`Database` in the sidebar.
+#. For the database deployment that contains the sample data,
+   click :guilabel:`Browse Collections`.
+#. In the left navigation pane, select the
+   :guilabel:`sample_mflix` database.
+#. Select the :guilabel:`movies` collection.

source/includes/steps-specify-query-filter.rst

@@ -0,0 +1,7 @@
+Specify the :ref:`query filter document <document-query-filter>`
+in the :guilabel:`Filter` field. A query filter document uses 
+:ref:`query operators <csfle-supported-query-operators>` to specify
+search conditions.
+
+Copy the following query filter document into the 
+:guilabel:`Filter` search bar:

source/tutorial/query-embedded-documents.txt

@@ -19,14 +19,14 @@ Query on Embedded/Nested Documents
    :backlinks: none
    :depth: 1
 
-----------
+You can query embedded documents in MongoDB by using the following
+methods:
 
-.. |arrow| unicode:: U+27A4
+.. |atlas-ref| replace:: :ref:`query-embedded-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
 
@@ -91,6 +91,39 @@ is less than ``15``, the nested field ``uom`` equals ``"in"``, and the
 
 .. include:: /includes/driver-examples/driver-example-query-19.rst
 
+.. _query-embedded-documents-atlas-ui:
+
+Query Embedded 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 query an embedded document in {+atlas+}, follow these steps:
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: Navigate to the collection
+
+      .. include:: /includes/steps-nav-atlas-sample-movies.rst
+
+   .. step:: Specify the query filter document
+
+      .. include:: /includes/steps-specify-query-filter.rst
+
+      .. code-block:: javascript
+
+         { "awards.wins": 1 }
+
+   .. step:: Click :guilabel:`Apply`
+
+      This query filter returns all documents in the 
+      ``sample_mflix.movies`` collection where the embedded  document
+      for the ``awards`` field contains ``{ wins: 1 }``.
+
 Additional Query Tutorials
 --------------------------
 

source/tutorial/remove-documents.txt

@@ -20,19 +20,11 @@ Delete Documents
 
 You can delete documents in MongoDB using the following methods:
 
-- Your programming language's driver
-- The :atlas:`{+atlas+} UI </>`. To learn more, see 
-  :ref:`delete-documents-atlas-ui`.
-- :compass:`MongoDB Compass </>`
+.. |atlas-ref| replace:: :ref:`delete-documents-atlas-ui`
 
-----------
+.. include:: /includes/fact-methods.rst
 
-.. |arrow| unicode:: U+27A4
-
-|arrow| Use the **Select your language** drop-down menu in the
-upper-right to set the language of the following examples.
-
-----------
+.. include:: /includes/language-selector-instructions.rst
 
 .. tabs-selector:: drivers
 
@@ -690,10 +682,7 @@ To delete a document in {+atlas+}, follow these steps:
 
    .. step:: Navigate to the collection.
 
-      a. In the {+atlas+} UI, click :guilabel:`Database` in the sidebar.
-      #. For the database deployment that contains the sample data, click :guilabel:`Browse Collections`.
-      #. In the left navigation pane, select the :guilabel:`sample_mflix` database.
-      #. Select the :guilabel:`movies` collection.
+      .. include:: /includes/steps-nav-atlas-sample-movies.rst
 
    .. step:: Specify a query filter document.