DOCSP-19964 update insert pt6 v5.1 (#102) (#105)

* DOCSP-19964 update insert pt6

* Add files

* Staging updates

Author: Dave

source/reference/operator/aggregation/toDouble.txt

@@ -134,7 +134,7 @@ Create a collection ``weather`` with the following documents:
 
 .. code-block:: javascript
 
-   db.weather.insert( [
+   db.weather.insertMany( [
       { _id: 1, date: new Date("2018-06-01"), temp: "26.1C" },
       { _id: 2,  date: new Date("2018-06-02"), temp: "25.1C" },
       { _id: 3,  date: new Date("2018-06-03"), temp: "25.4C" },
@@ -156,7 +156,7 @@ parses the ``temp`` value and converts to a double:
 
    db.weather.aggregate( [
       tempConversionStage,
-   ])
+   ] )
 
 The operation returns the following documents:
 
@@ -172,3 +172,4 @@ The operation returns the following documents:
    If the conversion operation encounters an error, the aggregation
    operation stops and throws an error. To override this behavior, use
    :expression:`$convert` instead.
+

source/reference/operator/aggregation/toInt.txt

@@ -152,16 +152,18 @@ Create a collection ``orders`` with the following documents:
 
 .. code-block:: javascript
 
-   db.orders.insert( [
-      { _id: 1, item: "apple", qty: 5, price: 10 },
-      { _id: 2, item: "pie", qty: 10, price: NumberDecimal("20.0") },
-      { _id: 3, item: "ice cream", qty: 2, price: "4.99" },
-      { _id: 4, item: "almonds" ,  qty: 5, price: 5 }
+   db.orders.insertMany( [
+      { _id: 1, item: "apple", qty: "5", price: 10 },
+      { _id: 2, item: "pie", qty: "10", price: NumberDecimal("20.0") },
+      { _id: 3, item: "ice cream", qty: "2", price: "4.99" },
+      { _id: 4, item: "almonds" ,  qty: "5", price: 5 }
    ] )
 
-The following aggregation operation on the ``orders`` collection
-converts the ``qty`` to an integer as well as convert ``price`` to a
-decimal before calculating the total price:
+The following aggregation operation:
+
+- converts ``qty`` to an integer,
+- converts ``price`` to a decimal,
+- calculates the total price:
 
 .. code-block:: javascript
 
@@ -184,16 +186,16 @@ decimal before calculating the total price:
    db.orders.aggregate( [
       priceQtyConversionStage,
       totalPriceCalculationStage
-   ])
+   ] )
 
 The operation returns the following documents:
 
 .. code-block:: javascript
 
-   { "_id" : 1, "item" : "apple", "totalPrice" : NumberDecimal("50.0000000000000") }
-   { "_id" : 2, "item" : "pie", "totalPrice" : NumberDecimal("200.0") }
-   { "_id" : 3, "item" : "ice cream", "totalPrice" : NumberDecimal("9.98") }
-   { "_id" : 4, "item" : "almonds", "totalPrice" : NumberDecimal("25.00000000000000") }
+   { _id: 1, item: 'apple', totalPrice: Decimal128("50") },
+   { _id: 2, item: 'pie', totalPrice: Decimal128("200.0") },
+   { _id: 3, item: 'ice cream', totalPrice: Decimal128("9.98") },
+   { _id: 4, item: 'almonds', totalPrice: Decimal128("25") }
 
 .. note::
 

source/reference/operator/aggregation/toLong.txt

@@ -64,8 +64,8 @@ long:
      - Behavior
 
    * - Boolean
-     - | Returns NumberLong(0) for  ``false``.
-       | Returns NumberLong(1) for ``true``.
+     - | Returns Long(0) for  ``false``.
+       | Returns Long(1) for ``true``.
 
 
    * - Double
@@ -114,34 +114,34 @@ The following table lists some conversion to long examples:
 
 .. list-table::
    :header-rows: 1
-   :widths: 80 20
+   :widths: 67 33
 
    * - Example
      - Results
 
    * - ``{ $toLong: true }``
-     - NumberLong("1")
+     - Long("1")
 
    * - ``{ $toLong: false }``
-     - NumberLong("0")
+     - Long("0")
 
    * - ``{ $toLong: 1.99999 }``
-     -  NumberLong("1")
+     -  Long("1")
 
    * - ``{ $toLong: NumberDecimal("5.5000") }``
-     - NumberLong("5")
+     - Long("5")
 
    * - ``{ $toLong: NumberDecimal("9223372036854775808.0") }``
      - Error
 
    * - ``{ $toLong: NumberInt(8) }``
-     - NumberLong(8)
+     - Long(8)
 
    * - ``{ $toLong: ISODate("2018-03-26T04:38:28.044Z") }``
-     -  NumberLong("1522039108044")
+     -  Long("1522039108044")
 
    * - ``{ $toLong: "-2" }``
-     - NumberLong("-2")
+     - Long("-2")
 
    * - ``{ $toLong: "2.5" }``
      - Error
@@ -156,10 +156,10 @@ Create a collection ``orders`` with the following documents:
 
 .. code-block:: javascript
 
-   db.orders.insert( [
+   db.orders.insertMany( [
       { _id: 1, item: "apple", qty: NumberInt(5) },
       { _id: 2, item: "pie", qty: "100" },
-      { _id: 3, item: "ice cream", qty: NumberLong(500) },
+      { _id: 3, item: "ice cream", qty: NumberLong("500") },
       { _id: 4, item: "almonds", qty: "50" },
    ] )
 
@@ -192,13 +192,14 @@ The operation returns the following documents:
 
 .. code-block:: javascript
 
-   { "_id" : 1, "item" : "apple", "qty" : 5, "convertedQty" : NumberLong(5) }
-   { "_id" : 2, "item" : "pie", "qty" : "100", "convertedQty" : NumberLong(100) }
-   { "_id" : 3, "item" : "ice cream", "qty" : NumberLong(500), "convertedQty" : NumberLong(500) }
-   { "_id" : 4, "item" : "almonds", "qty" : "50", "convertedQty" : NumberLong(50) }
+   { _id: 3, item: 'ice cream', qty: Long("500"), convertedQty: Long("500") },
+   { _id: 2, item: 'pie', qty: '100', convertedQty: Long("100") },
+   { _id: 4, item: 'almonds', qty: '50', convertedQty: Long("50") },
+   { _id: 1, item: 'apple', qty: 5, convertedQty: Long("5") }
 
 .. note::
 
    If the conversion operation encounters an error, the aggregation
    operation stops and throws an error. To override this behavior, use
    :expression:`$convert` instead.
+

source/reference/operator/aggregation/toObjectId.txt

@@ -70,7 +70,7 @@ The following table lists some conversion to date examples:
 
 .. list-table::
    :header-rows: 1
-   :widths: 80 20
+   :widths: 67 33
 
    * - Example
      - Results
@@ -89,7 +89,7 @@ Create a collection ``orders`` with the following documents:
 
 .. code-block:: javascript
 
-   db.orders.insert( [
+   db.orders.insertMany( [
       { _id: "5ab9cbe531c2ab715d42129a", item: "apple", qty: 10 },
       { _id: ObjectId("5ab9d0b831c2ab715d4212a8"), item: "pie", qty: 5 },
       { _id: ObjectId("5ab9d2d331c2ab715d4212b3"), item: "ice cream", qty: 20 },
@@ -119,19 +119,40 @@ converts the ``_id`` to ObjectId before sorting by the value:
    db.orders.aggregate( [
       idConversionStage,
       sortStage
-   ])
+   ] )
 
 The operation returns the following documents:
 
 .. code-block:: javascript
 
-   { "_id" : "5ab9e16431c2ab715d4212b4", "item" : "almonds", "qty" : 50, "convertedId" : ObjectId("5ab9e16431c2ab715d4212b4") }
-   { "_id" : ObjectId("5ab9d2d331c2ab715d4212b3"), "item" : "ice cream", "qty" : 20, "convertedId" : ObjectId("5ab9d2d331c2ab715d4212b3") }
-   { "_id" : ObjectId("5ab9d0b831c2ab715d4212a8"), "item" : "pie", "qty" : 5, "convertedId" : ObjectId("5ab9d0b831c2ab715d4212a8") }
-   { "_id" : "5ab9cbe531c2ab715d42129a", "item" : "apple", "qty" : 10, "convertedId" : ObjectId("5ab9cbe531c2ab715d42129a") }
+   {
+     _id: '5ab9e16431c2ab715d4212b4',
+     item: 'almonds',
+     qty: 50,
+     convertedId: ObjectId("5ab9e16431c2ab715d4212b4")
+   },
+   {
+     _id: ObjectId("5ab9d2d331c2ab715d4212b3"),
+     item: 'ice cream',
+     qty: 20,
+     convertedId: ObjectId("5ab9d2d331c2ab715d4212b3")
+   },
+   {
+     _id: ObjectId("5ab9d0b831c2ab715d4212a8"),
+     item: 'pie',
+     qty: 5,
+     convertedId: ObjectId("5ab9d0b831c2ab715d4212a8")
+   },
+   {
+     _id: '5ab9cbe531c2ab715d42129a',
+     item: 'apple',
+     qty: 10,
+     convertedId: ObjectId("5ab9cbe531c2ab715d42129a")
+   }
 
 .. note::
 
    If the conversion operation encounters an error, the aggregation
    operation stops and throws an error. To override this behavior, use
    :expression:`$convert` instead.
+

source/reference/operator/aggregation/toString.txt

@@ -122,12 +122,11 @@ Create a collection ``orders`` with the following documents:
 
 .. code-block:: javascript
 
-   db.orders.insert( [
-      { _id: 1, item: "apple",  qty: 5, zipcode: 12345 },
-      { _id: 2, item: "pie",  qty: 10, zipcode: 11111 },
-      { _id: 3, item: "ice cream",  zipcode: "12345" },
-      { _id: 4, item: "almonds", qty: 2, zipcode: "12345-0030" },
-   ])
+   db.orders.insertMany( [
+      { _id: 1, item: "apple",  qty: 5, zipcode: 93445 },
+      { _id: 2, item: "almonds", qty: 2, zipcode: "12345-0030" },
+      { _id: 3, item: "peaches",  qty: 5, zipcode: 12345 },
+   ] )
 
 The following aggregation operation on the ``orders`` collection
 converts the ``zipcode`` to string before sorting by the string value:
@@ -151,19 +150,37 @@ converts the ``zipcode`` to string before sorting by the string value:
    db.orders.aggregate( [
      zipConversionStage,
      sortStage
-   ])
+   ] )
 
 The operation returns the following documents:
 
 .. code-block:: javascript
 
-   { "_id" : 2, "item" : "pie", "qty" : 10, "zipcode" : 11111, "convertedZipCode" : "11111" }
-   { "_id" : 1, "item" : "apple", "qty" : 5, "zipcode" : 12345, "convertedZipCode" : "12345" }
-   { "_id" : 3, "item" : "ice cream", "zipcode" : "12345", "convertedZipCode" : "12345" }
-   { "_id" : 4, "item" : "almonds", "qty" : 2, "zipcode" : "12345-0030", "convertedZipCode" : "12345-0030" }
+   {
+     _id: 3,
+     item: 'peaches',
+     qty: 5,
+     zipcode: 12345,
+     convertedZipCode: '12345'
+   },
+   {
+     _id: 2,
+     item: 'almonds',
+     qty: 2,
+     zipcode: '12345-0030',
+     convertedZipCode: '12345-0030'
+   },
+   {
+     _id: 1,
+     item: 'apple',
+     qty: 5,
+     zipcode: 93445,
+     convertedZipCode: '93445'
+   }
 
 .. note::
 
    If the conversion operation encounters an error, the aggregation
    operation stops and throws an error. To override this behavior, use
    :expression:`$convert` instead.
+

source/reference/operator/query/jsonSchema.txt

@@ -15,8 +15,6 @@ Definition
 
 .. query:: $jsonSchema
 
-   .. versionadded:: 3.6
-
    The :query:`$jsonSchema` operator matches documents that satisfy
    the specified JSON Schema. 
 
@@ -175,59 +173,65 @@ operator to set schema validation rules:
             }
          }
       }
-   })
+   } )
 
 Given the created ``validator`` for the collection, the following insert
 operation will fail because ``gpa`` is an integer when the ``validator``
 requires a ``double``.
 
 .. code-block:: javascript
 
-   db.students.insert({
+   db.students.insertOne( {
       name: "Alice",
-      year: NumberInt(2019),
+      year: Int32( 2019 ),
       major: "History",
-      gpa: NumberInt(3),
+      gpa: Int32( 3 ),
       address: {
          city: "NYC",
          street: "33rd Street"
       }
-   })
+   } )
 
 The operation returns the following error:
 
 .. code-block:: javascript
    :copyable: false
 
-   WriteResult({
-      "nInserted" : 0,
-      "writeError" : {
-         "code" : 121,
-         "errmsg" : "Document failed validation"
-      }
-   })
+   MongoServerError: Document failed validation
+   Additional information: {
+     failingDocumentId: ObjectId("61aa577f666a50a8fccd7ec2"),
+     details: {
+       operatorName: '$jsonSchema',
+       schemaRulesNotSatisfied: [
+         {
+           operatorName: 'properties',
+           propertiesNotSatisfied: [
+             {
+               propertyName: 'gpa',
+               description: 'must be a double if the field exists',
+               details: [ [Object] ]
+             }
+           ]
+         }
+       ]
+     }
+   }
+
 
 After changing the ``gpa`` to a double, the insert succeeds:
 
 .. code-block:: javascript
 
-   db.students.insert({
+   db.students.insertOne( {
       name: "Alice",
       year: NumberInt(2019),
       major: "History",
-      gpa: 3.0,
+      gpa: Double(3.0),
       address: {
          city: "NYC",
          street: "33rd Street"
       }
-   })
-
-The operation returns the following:
-
-.. code-block:: javascript
-   :copyable: false
-   
-   WriteResult({ "nInserted" : 1 })
+   } )
 
 Query Conditions
 ~~~~~~~~~~~~~~~~
@@ -241,15 +245,15 @@ following documents:
 
 .. code-block:: javascript
 
-   db.inventory.insertMany([
+   db.inventory.insertMany( [
       { item: "journal", qty: NumberInt(25), size: { h: 14, w: 21, uom: "cm" }, instock: true },
       { item: "notebook", qty: NumberInt(50), size: { h: 8.5, w: 11, uom: "in" }, instock: true },
       { item: "paper", qty: NumberInt(100), size: { h: 8.5, w: 11, uom: "in" }, instock: 1 },
       { item: "planner", qty: NumberInt(75), size: { h: 22.85, w: 30, uom: "cm" }, instock: 1 },
       { item: "postcard", qty: NumberInt(45), size: { h: 10, w: 15.25, uom: "cm" }, instock: true },
       { item: "apple", qty: NumberInt(45), status: "A", instock: true },
       { item: "pears", qty: NumberInt(50), status: "A", instock: true }
-   ])
+   ] )
 
 Next, define the following sample schema object: