(DOCSP-7604): update multiple docs (#22)

* (DOCSP-7604): iupdate many doc

* updated link to update op

* updated link to update op

* updated link to update op

* updated link to update op

* added literal includes for code

* updated verbiage

* updated link

* updated verbiage and code

* updated code with additional options

* Removed unneeded comment

* updated verbiage

* updated code comments

* fixed grammar

* removed upsert opt

* removed upsert opt

* removed upsert opt

* removed upsert opt

* fixed grammar

* Removed unneeded line

* removed additional opts

Author: Mohammad Hunan Chughtai

source/code-snippets/usage-examples/updateMany.js

@@ -0,0 +1,32 @@
+// ignored first line
+const { MongoClient } = require("mongodb");
+
+// Replace the following with your MongoDB deployment's connection string.
+const uri =
+  "mongodb+srv://<user>:<password>@<cluster-url>?retryWrites=true&w=majority";
+
+const client = new MongoClient(uri);
+
+async function run() {
+  try {
+    await client.connect();
+
+    const database = client.db("sample_mflix");
+    const collection = database.collection("movies");
+
+    // create a filter to update all movies with a 'G' rating
+    const filter = { rated: "G" };
+
+    // increment every document matching the filter with 2 more comments
+    const updateDoc = {
+      $inc: {
+        num_mflix_comments: 2,
+      },
+    };
+    const result = await collection.updateMany(filter, updateDoc);
+    console.log(result);
+  } finally {
+    await client.close();
+  }
+}
+run().catch(console.dir);

source/usage-examples.txt

@@ -13,6 +13,7 @@ Usage Examples
 :doc:`findOne </usage-examples/findOne>`
 :doc:`insertMany </usage-examples/insertMany>`
 :doc:`updateOne</usage-examples/updateOne>`
+:doc:`updateMany</usage-examples/updateMany>`
 :doc:`replaceOne</usage-examples/replaceOne>`
 :doc:`distinct</usage-examples/distinct>`
 :doc:`command</usage-examples/command>`
@@ -30,6 +31,7 @@ Usage Examples
    /usage-examples/findOneAndUpdate
    /usage-examples/insertMany
    /usage-examples/updateOne
+   /usage-examples/updateMany
    /usage-examples/replaceOne
    /usage-examples/distinct
    /usage-examples/command

source/usage-examples/missing-link.txt

@@ -1,3 +1,4 @@
 sasquatch?
 duplicate key error explanation
-faq - diff b/w db.command({<crudMethod>}) and db.<crudMethod>
+bulk write operations
+faq - diff b/w db.command({<crudMethod>}) and db.<crudMethod>

source/usage-examples/updateMany.txt

@@ -0,0 +1,22 @@
+=========================
+Update Multiple Documents
+=========================
+
+.. default-domain:: mongodb
+
+You can update multiple documents using the ``updateMany()`` method. 
+``updateMany()`` accepts a filter object, and updates the documents
+that match the filter using a provided update document. The update
+document requires an :manual:`update operator
+</reference/operator/update>` to modify a field in a document.
+
+You can define additional query options using the options object passed as the third parameter of the ``updateMany()`` method. 
+
+The ``updateMany()`` method returns a `Promise
+<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise>`_
+that resolves to an object. The ``modifiedCount`` field of this object
+shows how many documents were modified.
+
+.. literalinclude:: /code-snippets/usage-examples/updateMany.js
+  :language: javascript
+  :linenos:

source/usage-examples/updateOne.txt

@@ -8,9 +8,7 @@ You can update a single document using the `updateOne()
 <https://mongodb.github.io/node-mongodb-native/3.3/api/Collection.html#updateOne>`_
 method. ``updateOne()`` accepts a filter document, and updates the first
 document that matches the filter using a provided update document. The
-update document requires an :manual:`Update
-Operator</reference/operator/update/#update-operators>`
-to modify a field in a document.
+update document requires an :manual:`Update Operator </reference/operator/update/#update-operators>` to modify a field in a document.
 
 Create an `Object
 <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object>`_