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

* 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

@@ -109,6 +109,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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -122,5 +164,8 @@ Use ``$push`` Operator with Multiple Modifiers
 
 .. include:: /includes/example-push-with-multiple-modifiers.rst
 
-.. seealso:: :method:`db.collection.update()`,
+.. seealso::
+   :method:`db.collection.update()`,
+   :method:`db.collection.updateMany()`,
    :method:`db.collection.findAndModify()`
+