DOCSP 22495 simplifying setEquals example (#1416) (#1460)

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 simplifying setEqual  example

* DOCSP-22495 adding note and fixing format

* DOCSP-22495 updating format of example

* DOCSP-22495 adding note and fixing format

* DOCSP-22495 adding note and fixing format

* DOCSP-22495 formatting updates

* DOCSP-22495 formatting fixes

* DOCSP-22495 tech review comments

* DOCSP-22495 tech review comments

Author: ltran-mdb

source/reference/operator/aggregation/setEquals.txt

@@ -64,42 +64,73 @@ Behavior
 Example
 -------
 
-Consider an ``experiments`` collection with the following documents:
+Consider a ``bakeryOrders`` collection with the following documents:
 
 .. code-block:: javascript
 
-   { "_id" : 1, "A" : [ "red", "blue" ], "B" : [ "red", "blue" ] }
-   { "_id" : 2, "A" : [ "red", "blue" ], "B" : [ "blue", "red", "blue" ] }
-   { "_id" : 3, "A" : [ "red", "blue" ], "B" : [ "red", "blue", "green" ] }
-   { "_id" : 4, "A" : [ "red", "blue" ], "B" : [ "green", "red" ] }
-   { "_id" : 5, "A" : [ "red", "blue" ], "B" : [ ] }
-   { "_id" : 6, "A" : [ "red", "blue" ], "B" : [ [ "red" ], [ "blue" ] ] }
-   { "_id" : 7, "A" : [ "red", "blue" ], "B" : [ [ "red", "blue" ] ] }
-   { "_id" : 8, "A" : [ ], "B" : [ ] }
-   { "_id" : 9, "A" : [ ], "B" : [ "red" ] }
+    db.bakeryOrders.insertMany( [
+       { _id: 0, cakes: ["chocolate", "vanilla"], cupcakes: ["chocolate", "vanilla"] },
+       { _id: 1, cakes: ["chocolate", "vanilla"], cupcakes: ["vanilla", "chocolate"] },
+       { _id: 2, cakes: ["chocolate", "chocolate"], cupcakes: ["chocolate"] },
+       { _id: 3, cakes: ["vanilla"], cupcakes: ["chocolate"] },
+       { _id: 4, cakes: ["vanilla"], cupcakes: [] }
+    ] )
 
 The following operation uses the :expression:`$setEquals` operator to
-determine if the ``A`` array and the ``B`` array
-contain the same elements:
+determine if the ``cakes`` array and the ``cupcakes`` array in each order
+contain the same flavors:
 
 .. code-block:: javascript
 
-   db.experiments.aggregate(
+   db.bakeryOrders.aggregate(
       [
-        { $project: { A: 1, B: 1, sameElements: { $setEquals: [ "$A", "$B" ] }, _id: 0 } }
-      ]
-   )
+         { 
+            $project: { 
+               _id: 0, 
+               cakes: 1, 
+               cupcakes: 1, 
+               sameFlavors: { $setEquals: [ "$cakes", "$cupcakes" ] } 
+            } 
+         }
+      ] )
+
+.. note:: $project
+
+   The :pipeline:`$project` stage specifies which fields are included
+   in the output documents. In this example, the :pipeline:`$project` 
+   stage:
+
+   - Excludes the ``_id`` field from the output.
+   - Includes the ``cakes`` and ``cupcakes`` fields in the output.
+   - Outputs the result of the ``$setEquals`` operator in a new field 
+     called ``sameFlavors``.
 
 The operation returns the following results:
 
 .. code-block:: javascript
 
-   { "A" : [ "red", "blue" ], "B" : [ "red", "blue" ], "sameElements" : true }
-   { "A" : [ "red", "blue" ], "B" : [ "blue", "red", "blue" ], "sameElements" : true }
-   { "A" : [ "red", "blue" ], "B" : [ "red", "blue", "green" ], "sameElements" : false }
-   { "A" : [ "red", "blue" ], "B" : [ "green", "red" ], "sameElements" : false }
-   { "A" : [ "red", "blue" ], "B" : [ ], "sameElements" : false }
-   { "A" : [ "red", "blue" ], "B" : [ [ "red" ], [ "blue" ] ], "sameElements" : false }
-   { "A" : [ "red", "blue" ], "B" : [ [ "red", "blue" ] ], "sameElements" : false }
-   { "A" : [ ], "B" : [ ], "sameElements" : true }
-   { "A" : [ ], "B" : [ "red" ], "sameElements" : false }
+   {
+    cakes: [ "chocolate", "vanilla" ],
+    cupcakes: [ "chocolate", "vanilla" ],
+    sameFlavors: true
+   },
+   {
+    cakes: [ "chocolate", "vanilla" ],
+    cupcakes: [ "vanilla", "chocolate" ],
+    sameFlavors: true
+   },
+   { 
+    cakes: [ "chocolate", "chocolate" ],
+    cupcakes: [ "chocolate" ],
+    sameFlavors: true
+   },
+   {
+    cakes: [ "vanilla" ],
+    cupcakes: [ "chocolate" ],
+    sameFlavors: false
+   },
+   { 
+      cakes: [ "vanilla" ], 
+      cupcakes: [], 
+      sameFlavors: false 
+   }