DOCSP-19939 update insert pt4 v5.1 (#91) (#97)

* DOCSP-19939 insert updates pt4

* Fix alignment

* Update extended json

Author: Dave

source/reference/method/db.collection.update.txt

@@ -918,7 +918,7 @@ with :method:`~db.collection.update()`.
 
       .. code-block:: javascript
 
-         db.books.insertMany([
+         db.books.insertMany( [
            {
              _id: 5,
              item: "RQM909",
@@ -933,7 +933,7 @@ with :method:`~db.collection.update()`.
              info: { publisher: "1111", pages: 72 },
              reorder: true
            }
-         ])
+         ] )
 
       The following operation specifies both the ``multi`` option and
       the ``upsert`` option. If matching documents exist, the
@@ -1067,10 +1067,10 @@ Create a ``members`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany([
+   db.members.insertMany( [
       { "_id" : 1, "member" : "abc123", "status" : "A", "points" : 2, "misc1" : "note to self: confirm status", "misc2" : "Need to activate", "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60, "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment", "lastUpdate" : ISODate("2019-01-01T00:00:00Z") }
-   ])
+   ] )
 
 Assume that instead of separate ``misc1`` and ``misc2`` fields, you
 want to gather these into a new ``comments`` field. The following
@@ -1133,11 +1133,11 @@ Create a ``students3`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.students3.insert([
+   db.students3.insertMany( [
       { "_id" : 1, "tests" : [ 95, 92, 90 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 2, "tests" : [ 94, 88, 90 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 3, "tests" : [ 70, 75, 82 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") }
-   ]);
+   ] )
 
 Using an aggregation pipeline, you can update the documents with the
 calculated grade average and letter grade.
@@ -1219,11 +1219,11 @@ collection with the following documents:
 
 .. code-block:: javascript
 
-   db.students.insertMany([
+   db.students.insertMany( [
       { "_id" : 1, "grades" : [ 95, 92, 90 ] },
       { "_id" : 2, "grades" : [ 98, 100, 102 ] },
       { "_id" : 3, "grades" : [ 95, 110, 100 ] }
-   ])
+   ] )
 
 To update all elements that are greater than or equal to ``100`` in the
 ``grades`` array, use the filtered positional operator
@@ -1260,7 +1260,7 @@ collection with the following documents:
 
 .. code-block:: javascript
 
-   db.students2.insertMany([
+   db.students2.insertMany( [
      {
        "_id" : 1,
        "grades" : [
@@ -1277,7 +1277,7 @@ collection with the following documents:
            { "grade" : 85, "mean" : 85, "std" : 4 }
         ]
      }
-   ])
+   ] )
 
 To modify the value of the ``mean`` field for all elements in the
 ``grades`` array where the grade is greater than or equal to ``85``,
@@ -1328,14 +1328,14 @@ collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany([
+   db.members.insertMany( [
       { "_id" : 1, "member" : "abc123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60,  "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" },
       { "_id" : 3, "member" : "lmn123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 4, "member" : "pqr123", "status" : "D", "points" : 20,  "misc1" : "Deactivated", "misc2" : null },
       { "_id" : 5, "member" : "ijk123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 6, "member" : "cde123", "status" : "A", "points" : 86,  "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" }
-   ])
+   ] )
 
 Create the following indexes on the collection:
 
@@ -1430,12 +1430,11 @@ In :binary:`~bin.mongosh`, create a collection named
 
 .. code-block:: javascript
 
-   db.myColl.insertMany(
-     [
+   db.myColl.insertMany( [
        { _id: 1, category: "café", status: "A" },
        { _id: 2, category: "cafe", status: "a" },
        { _id: 3, category: "cafE", status: "a" }
-     ])
+   ] )
 
 The following operation includes the :ref:`collation <collation>`
 option and sets ``multi`` to ``true`` to update all matching documents:

source/reference/method/db.collection.updateMany.txt

@@ -413,10 +413,10 @@ Create a ``members`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany([
+   db.members.insertMany( [
       { "_id" : 1, "member" : "abc123", "status" : "A", "points" : 2, "misc1" : "note to self: confirm status", "misc2" : "Need to activate", "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60, "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment", "lastUpdate" : ISODate("2019-01-01T00:00:00Z") }
-   ])
+   ] )
 
 Assume that instead of separate ``misc1`` and ``misc2`` fields, you
 want to gather these into a new ``comments`` field. The following
@@ -477,11 +477,11 @@ For example, create a ``students3`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.students3.insert([
+   db.students3.insertMany( [
       { "_id" : 1, "tests" : [ 95, 92, 90 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 2, "tests" : [ 94, 88, 90 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 3, "tests" : [ 70, 75, 82 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") }
-   ]);
+   ] )
 
 Using an aggregation pipeline, you can update the documents with the
 calculated grade average and letter grade.
@@ -682,11 +682,11 @@ Create a collection ``students`` with the following documents:
 
 .. code-block:: javascript
 
-   db.students.insert([
+   db.students.insertMany( [
       { "_id" : 1, "grades" : [ 95, 92, 90 ] },
       { "_id" : 2, "grades" : [ 98, 100, 102 ] },
       { "_id" : 3, "grades" : [ 95, 110, 100 ] }
-   ])
+   ] )
 
 To update all elements that are greater than or equal to ``100`` in the
 ``grades`` array, use the filtered positional operator
@@ -716,7 +716,7 @@ Create a collection ``students2`` with the following documents:
 
 .. code-block:: javascript
 
-   db.students2.insert([
+   db.students2.insertMany( [
       {
          "_id" : 1,
          "grades" : [
@@ -733,7 +733,7 @@ Create a collection ``students2`` with the following documents:
             { "grade" : 85, "mean" : 85, "std" : 4 }
          ]
       }
-   ])
+   ] )
 
 
 To modify the value of the ``mean`` field for all elements in the
@@ -782,14 +782,14 @@ Create a sample ``members`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany([
+   db.members.insertMany( [
       { "_id" : 1, "member" : "abc123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60,  "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" },
       { "_id" : 3, "member" : "lmn123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 4, "member" : "pqr123", "status" : "D", "points" : 20,  "misc1" : "Deactivated", "misc2" : null },
       { "_id" : 5, "member" : "ijk123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 6, "member" : "cde123", "status" : "A", "points" : 86,  "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" }
-   ])
+   ] )
 
 Create the following indexes on the collection:
 

source/reference/method/db.collection.updateOne.txt

@@ -480,10 +480,10 @@ Create a ``members`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany([
+   db.members.insertMany( [
        { "_id" : 1, "member" : "abc123", "status" : "A", "points" : 2, "misc1" : "note to self: confirm status", "misc2" : "Need to activate", "lastUpdate" : ISODate("2019-01-01T00:00:00Z") },
        { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60, comments: [ "reminder: ping me at 100pts", "Some random comment" ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") }
-   ])
+   ] )
 
 Assume that instead of separate ``misc1`` and ``misc2`` fields in the
 first document, you want to gather these into a ``comments`` field,
@@ -547,11 +547,11 @@ For example, create a ``students3`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.students3.insert([
+   db.students3.insertMany( [
       { "_id" : 1, "tests" : [ 95, 92, 90 ], "average" : 92, "grade" : "A", "lastUpdate" : ISODate("2020-01-23T05:18:40.013Z") },
       { "_id" : 2, "tests" : [ 94, 88, 90 ], "average" : 91, "grade" : "A", "lastUpdate" : ISODate("2020-01-23T05:18:40.013Z") },
       { "_id" : 3, "tests" : [ 70, 75, 82 ], "lastUpdate" : ISODate("2019-01-01T00:00:00Z") }
-   ]);
+   ] )
 
 The third document ``_id: 3`` is missing the ``average`` and ``grade``
 fields. Using an aggregation pipeline, you can update the document with
@@ -795,11 +795,11 @@ Create a collection ``students`` with the following documents:
 
 .. code-block:: javascript
 
-   db.students.insert([
+   db.students.insertMany( [
       { "_id" : 1, "grades" : [ 95, 92, 90 ] },
       { "_id" : 2, "grades" : [ 98, 100, 102 ] },
       { "_id" : 3, "grades" : [ 95, 110, 100 ] }
-   ])
+   ] )
 
 To modify all elements that are greater than or equal to ``100`` in the
 ``grades`` array, use the filtered positional operator
@@ -831,7 +831,7 @@ Create a collection ``students2`` with the following documents:
 
 .. code-block:: javascript
 
-   db.students2.insert([
+   db.students2.insertMany( [
       {
          "_id" : 1,
          "grades" : [
@@ -848,7 +848,7 @@ Create a collection ``students2`` with the following documents:
             { "grade" : 85, "mean" : 85, "std" : 4 }
          ]
       }
-   ])
+   ] )
 
 To modify the value of the ``mean`` field for all elements in the
 ``grades`` array where the grade is greater than or equal to ``85``,
@@ -897,14 +897,14 @@ Create a sample ``members`` collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany([
+   db.members.insertMany( [
       { "_id" : 1, "member" : "abc123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60,  "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" },
       { "_id" : 3, "member" : "lmn123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 4, "member" : "pqr123", "status" : "D", "points" : 20,  "misc1" : "Deactivated", "misc2" : null },
       { "_id" : 5, "member" : "ijk123", "status" : "P", "points" :  0,  "misc1" : null, "misc2" : null },
       { "_id" : 6, "member" : "cde123", "status" : "A", "points" : 86,  "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" }
-   ])
+   ] )
 
 Create the following indexes on the collection:
 

source/reference/method/db.createCollection.txt

@@ -466,8 +466,6 @@ for the past 24 hours, issue this command:
 Create a Collection with Document Validation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 3.2
-
 Collections with validation compare each inserted or updated document
 against the criteria specified in the ``validator`` option. Depending
 on the ``validationLevel`` and ``validationAction``, MongoDB either
@@ -477,11 +475,6 @@ fails to meet the specified criteria.
 The following example creates a ``contacts`` collection with a JSON
 Schema validator:
 
-.. note::
-
-   MongoDB 3.6 adds the :query:`$jsonSchema` operator to support JSON
-   Schema validation.
-
 .. code-block:: json
 
    db.createCollection( "contacts", {
@@ -510,23 +503,45 @@ With the validator in place, the following insert operation fails validation:
 
 .. code-block:: javascript
 
-   db.contacts.insert( { name: "Amanda", status: "Updated" } )
+   db.contacts.insertOne( { name: "Amanda", status: "Updated" } )
 
-The method returns the error in the ``WriteResult``:
+The method returns the error:
 
 .. code-block:: javascript
 
-   WriteResult({
-      "nInserted" : 0,
-      "writeError" : {
-         "code" : 121,
-         "errmsg" : "Document failed validation"
-      }
-   })
-
-For more information, see :doc:`/core/schema-validation`. To view the
-validation specifications for a collection, use the
-:method:`db.getCollectionInfos()` method.
+     Uncaught:
+     MongoServerError: Document failed validation
+     Additional information: {
+       failingDocumentId: ObjectId("61a8f4847a818411619e952e"),
+       details: {
+         operatorName: '$jsonSchema',
+         schemaRulesNotSatisfied: [
+           {
+             operatorName: 'properties',
+             propertiesNotSatisfied: [
+               {
+                 propertyName: 'status',
+                 description: 'can only be one of the enum values',
+                 details: [ [Object] ]
+               }
+             ]
+           },
+           {
+             operatorName: 'required',
+             specifiedAs: { required: [ 'phone' ] },
+             missingProperties: [ 'phone' ]
+           }
+         ]
+       }
+     }
+
+To view the validation specifications for a collection, use
+:method:`db.getCollectionInfos()`.
+
+.. seealso::
+
+   - :doc:`/core/schema-validation`
+   - :query:`$jsonSchema`
 
 .. _createCollection-collation-example:
 

source/reference/method/js-collection.txt

@@ -130,10 +130,6 @@ Collection Methods
 
      - Hides an index from the query planner.
 
-   * - :method:`db.collection.insert()`
-
-     - Creates a new document in a collection.
-
    * - :method:`db.collection.insertOne()`
 
      - Inserts a new document in a collection.