DOCSP 22373 - adding updateMany() example to push (#1455) (#1470)

* DOCSP-22373 adding new push example

* DOCSP-22373 adding new push example

* DOCSP-22373 adding new push example

* DOCSP-22373 adding new push example

* DOCSP-22373 adding new push example

* DOCSP-22373 minor edits

* DOCSP-22373 minor word change

Author: ltran-mdb

source/reference/operator/update/push.txt

@@ -111,6 +111,48 @@ The following example appends ``89`` to the ``scores`` array:
 
 .. _example-push-each:
 
+Append a Value to Arrays in Multiple Documents
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Add the following documents to the ``students`` collection: 
+
+.. code-block:: javascript
+   
+   db.students.insertMany( [
+      { _id: 2, scores: [ 45, 78, 38, 80, 89 ] } ,
+      { _id: 3, scores: [ 46, 78, 38, 80, 89 ] } ,
+      { _id: 4, scores: [ 47, 78, 38, 80, 89 ] } 
+   ] )
+
+The following :update:`$push` operation appends ``95`` to the
+``scores`` array in each document:
+
+.. code-block:: javascript
+
+   db.students.updateMany(
+      { },
+      { $push: { scores: 95 } }
+   )
+
+To confirm that each ``scores`` array includes ``95``, run the following
+operation:
+
+.. code-block:: javascript
+
+   db.students.find()
+
+The operation returns the following results: 
+
+.. code-block:: javascript
+   :copyable: false
+   
+   [
+      { _id: 1, scores: [ 44, 78, 38, 80, 89, 95 ] },
+      { _id: 2, scores: [ 45, 78, 38, 80, 89, 95 ] },
+      { _id: 3, scores: [ 46, 78, 38, 80, 89, 95 ] },
+      { _id: 4, scores: [ 47, 78, 38, 80, 89, 95 ] }
+   ]
+
 Append Multiple Values to an Array
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -127,4 +169,5 @@ Use ``$push`` Operator with Multiple Modifiers
 .. seealso::
 
    - :method:`db.collection.update()`
+   - :method:`db.collection.updateMany()`
    - :method:`db.collection.findAndModify()`