DOCSP-1389 - Updates per Ravind's feedback

Author: jeff-allen-mongo

source/images/compass-project-all-fields.png

@@ -20,6 +20,22 @@
 
             .. include:: /includes/fact-mws.rst
 
+     - id: compass
+       content: |
+         .. code-block:: javascript
+
+            [
+              { item: "journal", status: "A", size: { h: 14, w: 21, uom: "cm" }, instock: [ { warehouse: "A", qty: 5 } ] },
+              { item: "notebook", status: "A",  size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "C", qty: 5 } ] },
+              { item: "paper", status: "D", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "A", qty: 60 } ] },
+              { item: "planner", status: "D", size: { h: 22.85, w: 30, uom: "cm" }, instock: [ { warehouse: "A", qty: 40 } ] },
+              { item: "postcard", status: "A", size: { h: 10, w: 15.25, uom: "cm" }, instock: [ { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ] }
+            ]
+
+         For instructions on inserting documents in MongoDB Compass,
+         see :doc:`Insert Documents </tutorial/insert-documents>`.
+
+
      - id: python
        content: |
          .. class:: copyable-code

source/images/compass-project-embedded-array-docs.png

@@ -8,6 +8,10 @@
 
             db.inventory.find( { status: "A" } )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-all-fields.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/images/compass-project-embedded-fields.png

@@ -8,6 +8,10 @@
 
             db.inventory.find( { status: "A" }, { item: 1, status: 1 } )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-specified-plus-id.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/images/compass-project-exclude-fields.png

@@ -8,6 +8,10 @@
 
             db.inventory.find( { status: "A" }, { item: 1, status: 1, _id: 0 } )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-suppress-id.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/images/compass-project-specified-plus-id.png

@@ -8,6 +8,10 @@
 
             db.inventory.find( { status: "A" }, { status: 0, instock: 0 } )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-exclude-fields.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/images/compass-project-suppress-embedded-field.png

@@ -11,6 +11,10 @@
                { item: 1, status: 1, "size.uom": 1 }
             )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-embedded-fields.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/images/compass-project-suppress-id.png

@@ -11,6 +11,10 @@
                { "size.uom": 0 }
             )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-suppress-embedded-field.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-42.rst

@@ -8,6 +8,10 @@
 
             db.inventory.find( { status: "A" }, { item: 1, status: 1, "instock.qty": 1 } )
 
+     - id: compass
+       content: |
+         .. figure:: /images/compass-project-embedded-array-docs.png
+
      - id: python
        content: |
          .. class:: copyable-code

source/includes/driver-example-query-43.rst

@@ -6,7 +6,7 @@
          .. class:: copyable-code
          .. code-block:: javascript
 
-            db.inventory.find( { status: "A" }, { name: 1, status: 1, instock: { $slice: -1 } } )
+            db.inventory.find( { status: "A" }, { item: 1, status: 1, instock: { $slice: -1 } } )
 
      - id: python
        content: |

source/includes/driver-example-query-44.rst

@@ -9,6 +9,13 @@
          ``inventory`` collection. To populate the ``inventory``
          collection, run the following:
 
+     - id: compass
+       content: |
+         This page provides examples of |query_operations| in
+         :ref:`MongoDB Compass <compass-index>`. The examples on this
+         page use the ``inventory`` collection. Populate the
+         ``inventory`` collection with the following documents:
+
      - id: python
        content: |
          This page provides examples of |query_operations| using the

source/includes/driver-example-query-45.rst

@@ -0,0 +1,3 @@
+For fields that contain arrays, MongoDB provides the following
+projection operators for manipulating arrays: :projection:`$elemMatch`,
+:projection:`$slice`, and :projection:`$`.

source/includes/driver-example-query-46.rst

@@ -0,0 +1,2 @@
+The following example uses the :projection:`$slice` projection operator
+to return the last element in the ``instock`` array:

source/includes/driver-example-query-47.rst

@@ -79,7 +79,7 @@ Return All Fields in Matching Documents
      - id: scala
        content: |
          If you do not specify a :term:`projection`, the
-         :scala-api:`collection.find()<find[C](filter:org.mongodb.scala.bson.conversions.Bson)(implicite:org.mongodb.scala.bson.DefaultHelper.DefaultsTo[C,TResult],implicitct:scala.reflect.ClassTag[C]):org.mongodb.scala.FindObservable[C]>` 
+         :scala-api:`collection.find()<find[C](filter:org.mongodb.scala.bson.conversions.Bson)(implicite:org.mongodb.scala.bson.DefaultHelper.DefaultsTo[C,TResult],implicitct:scala.reflect.ClassTag[C]):org.mongodb.scala.FindObservable[C]>`
          method returns all fields in the matching documents.
 
      - id: csharp
@@ -141,8 +141,10 @@ fields in the matching documents:
 
 .. include:: /includes/driver-example-query-46.rst
 
-With the exception of the ``_id`` field, you cannot combine inclusion
-and exclusion statements in projection documents.
+.. note::
+
+   With the exception of the ``_id`` field, you cannot combine inclusion
+   and exclusion statements in projection documents.
 
 Return Specific Fields in Embedded Documents
 --------------------------------------------
@@ -151,9 +153,14 @@ You can return specific fields in an embedded document. Use the
 :ref:`dot notation <document-dot-notation>` to refer to the embedded
 field and set to ``1`` in the projection document.
 
-The following example returns: the ``_id`` field (returned by default),
-``item`` field, ``status`` field, and the ``uom`` field in the ``size``
-document; the ``uom`` field remains embedded in the ``size`` document.
+The following example returns:
+
+- The ``_id`` field (returned by default),
+- The ``item`` field,
+- The ``status`` field,
+- The ``uom`` field in the ``size`` document.
+
+The ``uom`` field remains embedded in the ``size`` document.
 
 .. include:: /includes/driver-example-query-47.rst
 
@@ -176,39 +183,53 @@ Projection on Embedded Documents in an Array
 Use :ref:`dot notation <document-dot-notation>` to project specific
 fields inside documents embedded in an array.
 
-The following example specifies a projection to return the ``item``
-field, the ``status`` field, and the ``qty`` field in the documents
-embedded in the ``instock`` array. The ``_id`` field is returned by
-default.
+The following example specifies a projection to return:
+
+- The ``_id`` field (returned by default),
+- The ``item`` field,
+- The ``status`` field,
+- The ``qty`` field in the documents embedded in the ``instock`` array.
 
 .. include:: /includes/driver-example-query-49.rst
 
 Project Specific Array Elements in the Returned Array
 -----------------------------------------------------
 
-For fields that contain arrays, MongoDB provides the following
-projection operators: :projection:`$elemMatch`, :projection:`$slice`,
-and :projection:`$`.
-
-The following example uses the :projection:`$slice` projection operator
-to return just the last element in the ``instock`` array.
-
-.. include:: /includes/driver-example-query-50.rst
-
 .. tabs-drivers::
 
    tabs:
      - id: shell
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
          project specific array elements using the array index; e.g.
          ``{ "instock.0": 1 }`` projection will *not* project the array
          with the first element.
 
+     - id: compass
+       content: |
+         Currently, MongoDB Compass does not support any methods for
+         projecting specific array elements in a returned array.
+
+         For additional details and examples on projection in MongoDB
+         Compass, refer to the Compass
+         :ref:`Query Bar <query-bar-project>` documentation.
+
      - id: python
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -218,6 +239,12 @@ to return just the last element in the ``instock`` array.
 
      - id: java-sync
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -227,6 +254,12 @@ to return just the last element in the ``instock`` array.
 
      - id: java-async
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -236,6 +269,12 @@ to return just the last element in the ``instock`` array.
 
      - id: nodejs
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -245,6 +284,12 @@ to return just the last element in the ``instock`` array.
 
      - id: php
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -254,6 +299,12 @@ to return just the last element in the ``instock`` array.
 
      - id: perl
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -263,6 +314,12 @@ to return just the last element in the ``instock`` array.
 
      - id: ruby
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -272,6 +329,12 @@ to return just the last element in the ``instock`` array.
 
      - id: scala
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array. For instance, you *cannot*
@@ -281,6 +344,12 @@ to return just the last element in the ``instock`` array.
 
      - id: csharp
        content: |
+         .. include:: /includes/fact-projection-ops.rst
+
+         .. include:: /includes/fact-projection-slice-example.rst
+
+         .. include:: /includes/driver-example-query-50.rst
+
          :projection:`$elemMatch`, :projection:`$slice`, and
          :projection:`$` are the *only* way to project specific elements
          to include in the returned array.
@@ -300,3 +369,4 @@ to return just the last element in the ``instock`` array.
      - id: shell
        content: |
          .. include:: /includes/footnote-set-shell-batch-size.rst
+