DOCSP-19981 insert updates pt7 v5.1 (#106)

* DOCSP-19981 insert updates pt7

* DOCSP-19981 insert updates pt7

* Fix upstream merge conflict

* Method swaps

* Old include

* Staging updates

* Review comments

Author: Dave

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

@@ -18,9 +18,6 @@ Definition
 
    .. include:: /includes/fact-mongosh-shell-method.rst
 
-
-   .. versionadded:: 3.2
-
    Inserts multiple documents into a collection.
 
    The :method:`~db.collection.insertMany()` method has the following
@@ -131,7 +128,7 @@ unique within the collection to avoid duplicate key error.
 Explainability
 ~~~~~~~~~~~~~~
 
-:method:`~db.collection.insertMany()` is not compatible with 
+:method:`~db.collection.insertMany()` is not compatible with
 :method:`db.collection.explain()`.
 
 Error Handling

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

@@ -18,9 +18,6 @@ Definition
 
    .. include:: /includes/fact-mongosh-shell-method.rst
 
-
-   .. versionadded:: 3.2
-
    Inserts a document into a collection.
 
    The :method:`~db.collection.insertOne()` method has the following
@@ -102,7 +99,7 @@ unique within the collection to avoid duplicate key error.
 Explainability
 ~~~~~~~~~~~~~~
 
-:method:`~db.collection.insertOne()` is not compatible with 
+:method:`~db.collection.insertOne()` is not compatible with
 :method:`db.collection.explain()`.
 
 Error Handling

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

@@ -15,11 +15,7 @@ Definition
 
 .. method:: db.collection.updateMany(filter, update, options)
 
-
    .. include:: /includes/fact-mongosh-shell-method.rst
-
-
-   .. versionadded:: 3.2
 
    Updates all documents that match the specified filter for a
    collection.
@@ -307,7 +303,7 @@ full shard key in the ``filter``.
 Explainability
 ~~~~~~~~~~~~~~
 
-:method:`~db.collection.updateMany()` is not compatible with 
+:method:`~db.collection.updateMany()` is not compatible with
 :method:`db.collection.explain()`.
 
 Transactions

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

@@ -380,7 +380,7 @@ See also:
 Explainability
 ~~~~~~~~~~~~~~
 
-:method:`~db.collection.updateOne()` is not compatible with 
+:method:`~db.collection.updateOne()` is not compatible with
 :method:`db.collection.explain()`.
 
 Transactions

source/reference/program/mongo.txt

@@ -381,8 +381,6 @@ Core Options
 
 .. option:: --disableJavaScriptProtection
 
-   .. versionadded:: 3.4
-   
    Allows fields of type :ref:`javascript<bson-types>` and
    :ref:`javascriptWithScope (*Deprecated*) <bson-types>` to be automatically
    marshalled to JavaScript functions in the :binary:`~bin.mongo`
@@ -393,12 +391,13 @@ Core Options
    The following example demonstrates this behavior within the shell:
 
    .. code-block:: javascript
-   
-      > db.test.insert({ _id: 1, jsFunc: function(){ print("hello") } } )
+      :copyable: false
+
+      > db.test.insertOne( { _id: 1, jsFunc: function(){ print( "hello" ) } } )
       WriteResult({ "nInserted" : 1 })
-      > var doc = db.test.findOne({ _id: 1 })
+      > var doc = db.test.findOne( { _id: 1 } )
       > doc
-      { "_id" : 1, "jsFunc" : function (){ print ("hello") } }
+      { "_id" : 1, "jsFunc" : function (){ print ( "hello" ) } }
       > typeof doc.jsFunc
       function
       > doc.jsFunc()
@@ -411,22 +410,20 @@ Core Options
    within the shell:
 
    .. code-block:: javascript
-   
-      > db.test.insert({ _id: 1, jsFunc: function(){ print("hello") } } )
+      :copyable: false
+
+      > db.test.insertOne( { _id: 1, jsFunc: function(){ print("hello") } } )
       WriteResult({ "nInserted" : 1 })
-      > var doc = db.test.findOne({ _id: 1 })
+      > var doc = db.test.findOne( { _id: 1 } )
       > doc
       { "_id" : 1, "jsFunc" : { "code" : "function (){print(\"hello\")}" } }
-      > typeof doc.func
+      > typeof doc.jsFunc
       object
-      > doc.func instanceof Code
+      > doc.jsFunc instanceof Code
       true
       > doc.jsFunc()
-      2016-11-09T12:30:36.808-08:00 E QUERY    [thread1] TypeError: doc.jsFunc is
-      not a function :
+      uncaught exception: TypeError: doc.jsFunc is not a function :
       @(shell):1:1
-   
-
 
 .. _mongo-shell-file:
 

source/reference/read-concern.txt

@@ -12,8 +12,6 @@ Read Concern
    :depth: 1
    :class: singlecol
 
-
-
 The ``readConcern`` option allows you to control the consistency and
 isolation properties of the data read from replica sets and replica set
 shards.
@@ -397,8 +395,8 @@ of a multi-document transaction:
      - :readconcern:`"linearizable"`
 
    * - | :dbcommand:`delete`
-       | :method:`db.collection.deleteMany()`
        | :method:`db.collection.deleteOne()`
+       | :method:`db.collection.deleteMany()`
        | :method:`db.collection.remove()`
      - |checkmark|
      - 
@@ -419,7 +417,6 @@ of a multi-document transaction:
      - 
 
    * - | :dbcommand:`insert`
-       | :method:`db.collection.insert()`
        | :method:`db.collection.insertOne()`
        | :method:`db.collection.insertMany()`
 
@@ -430,8 +427,8 @@ of a multi-document transaction:
      - 
 
    * - | :dbcommand:`update`
-       | :method:`db.collection.updateMany()`
        | :method:`db.collection.updateOne()`
+       | :method:`db.collection.updateMany()`
        | :method:`db.collection.replaceOne()`
 
      - |checkmark| 

source/tutorial/configure-audit-filters.txt

@@ -224,14 +224,24 @@ enable the audit system to log authorization successes using the
 
    .. include:: /includes/fact-auditAuthorizationSuccess-performance-impact.rst
 
-The following example audits the :method:`~db.collection.find()`,
-:method:`~db.collection.insert()`, :method:`~db.collection.remove()`,
-:method:`~db.collection.update()`, and
-:method:`~db.collection.findAndModify()` operations by using the filter:
+This filter audits multiple read and write operations:
 
 .. code-block:: bash
 
-   { atype: "authCheck", "param.command": { $in: [ "find", "insert", "delete", "update", "findandmodify" ] } }
+   {
+      atype: "authCheck",
+      "param.command": { $in: [ "find", "insert", "delete", "update", "findandmodify" ] }
+   }
+
+The audited operations include:
+
+- :method:`~db.collection.find()`
+- :method:`~db.collection.insertOne()`
+- :method:`~db.collection.insertMany()`
+- :method:`~db.collection.remove()`
+- :method:`~db.collection.updateOne()`
+- :method:`~db.collection.updateMany()`
+- :method:`~db.collection.findAndModify()`
 
 .. include:: /includes/fact-audit-filter-single-quotes.rst
 
@@ -269,15 +279,27 @@ enable the audit system to log authorization successes using the
 
    .. include:: /includes/fact-auditAuthorizationSuccess-performance-impact.rst
 
-The following example audits the :method:`~db.collection.find()`,
-:method:`~db.collection.insert()`, :method:`~db.collection.remove()`,
-:method:`~db.collection.update()`, and
-:method:`~db.collection.findAndModify()` operations for the collection
-``orders`` in the database ``test`` by using the filter:
+This filter audits multiple read and write operations on the ``orders``
+collection in the ``test`` database:
 
 .. code-block:: bash
 
-   { atype: "authCheck", "param.ns": "test.orders", "param.command": { $in: [ "find", "insert", "delete", "update", "findandmodify" ] } }
+   {
+       atype: "authCheck",
+       "param.ns": "test.orders",
+       "param.command": { $in: [ "find", "insert", "delete", "update", "findandmodify" ] }
+   }
+
+The audited operations include: 
+
+- :method:`~db.collection.find()`
+- :method:`~db.collection.insertOne()`
+- :method:`~db.collection.insertMany()`
+- :method:`~db.collection.remove()`
+- :method:`~db.collection.updateOne()`
+- :method:`~db.collection.updateMany()`
+- :method:`~db.collection.findAndModify()`
+
 
 .. include:: /includes/fact-audit-filter-single-quotes.rst
 

source/tutorial/configure-replica-set-tag-sets.txt

@@ -241,4 +241,8 @@ Given a five member replica set with members in two data centers:
 
    .. code-block:: javascript
 
-      db.collection.insert( { id: "xyz", status: "A" }, { writeConcern: { w: "MultipleDC" } } )
+      db.collection.insertOne(
+         { id: "xyz", status: "A" },
+         { writeConcern: { w: "MultipleDC" } }
+      )
+

source/tutorial/expire-data.txt

@@ -59,19 +59,19 @@ field has passed since the time specified in its indexed field.
 
 For example, the following operation creates an index on the
 ``log_events`` collection's ``createdAt`` field and specifies the
-``expireAfterSeconds`` value of ``3600`` to set the expiration time to
-be one hour after the time specified by ``createdAt``.
+``expireAfterSeconds`` value of ``10`` to set the expiration time to
+be ten seconds after the time specified by ``createdAt``.
 
 .. code-block:: javascript
 
-   db.log_events.createIndex( { "createdAt": 1 }, { expireAfterSeconds: 3600 } )
+   db.log_events.createIndex( { "createdAt": 1 }, { expireAfterSeconds: 10 } )
 
 When adding documents to the ``log_events`` collection, set the
 ``createdAt`` field to the current time:
 
 .. code-block:: javascript
 
-   db.log_events.insert( {
+   db.log_events.insertOne( {
       "createdAt": new Date(),
       "logEvent": 2,
       "logMessage": "Success!"
@@ -107,13 +107,13 @@ For example, the following operation creates an index on the
    db.log_events.createIndex( { "expireAt": 1 }, { expireAfterSeconds: 0 } )
 
 For each document, set the value of ``expireAt`` to correspond to the
-time the document should expire. For instance, the following
-:method:`~db.collection.insert()` operation adds a document that should
-expire at ``July 22, 2013 14:00:00``.
+time the document should expire. For example, the following
+:method:`~db.collection.insertOne()` operation adds a document that
+expires at ``July 22, 2013 14:00:00``.
 
 .. code-block:: javascript
 
-   db.log_events.insert( {
+   db.log_events.insertOne( {
       "expireAt": new Date('July 22, 2013 14:00:00'),
       "logEvent": 2,
       "logMessage": "Success!"
@@ -124,3 +124,4 @@ collection when the documents' ``expireAt`` value is older than the
 number of seconds specified in ``expireAfterSeconds``, i.e. ``0``
 seconds older in this case. As such, the data expires at the specified
 ``expireAt`` value.
+

source/tutorial/update-documents-with-aggregation-pipeline.txt

@@ -38,11 +38,11 @@ not currently exist, insert operations will create the collection):
 
 .. code-block:: javascript
 
-   db.students.insertMany([
+   db.students.insertMany( [
       { _id: 1, test1: 95, test2: 92, test3: 90, modified: new Date("01/05/2020") },
       { _id: 2, test1: 98, test2: 100, test3: 102, modified: new Date("01/05/2020") },
       { _id: 3, test1: 95, test2: 110, modified: new Date("01/04/2020") }
-   ])
+   ] )
 
 To verify, query the collection:
 
@@ -86,10 +86,10 @@ currently exist, insert operations will create the collection):
 
 .. code-block:: javascript
 
-   db.students2.insertMany([
+   db.students2.insertMany( [
       { "_id" : 1, quiz1: 8, test2: 100, quiz2: 9, modified: new Date("01/05/2020") },
       { "_id" : 2, quiz2: 5, test1: 80, test2: 89, modified: new Date("01/05/2020") },
-   ])
+   ] )
 
 To verify, query the collection:
 
@@ -152,11 +152,11 @@ currently exist, insert operations will create the collection):
 
 .. code-block:: javascript
 
-   db.students3.insert([
+   db.students3.insertMany( [
       { "_id" : 1, "tests" : [ 95, 92, 90 ], "modified" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 2, "tests" : [ 94, 88, 90 ], "modified" : ISODate("2019-01-01T00:00:00Z") },
       { "_id" : 3, "tests" : [ 70, 75, 82 ], "modified" : ISODate("2019-01-01T00:00:00Z") }
-   ]);
+   ] );
 
 To verify, query the collection:
 
@@ -221,11 +221,11 @@ not currently exist, insert operations will create the collection):
 
 .. code-block:: javascript
 
-   db.students4.insertMany([
+   db.students4.insertMany( [
      { "_id" : 1, "quizzes" : [ 4, 6, 7 ] },
      { "_id" : 2, "quizzes" : [ 5 ] },
      { "_id" : 3, "quizzes" : [ 10, 10, 10 ] }
-   ])
+   ] )
 
 To verify, query the collection:
 
@@ -267,11 +267,11 @@ insert operations will create the collection):
 
 .. code-block:: javascript
 
-   db.temperatures.insertMany([
+   db.temperatures.insertMany( [
      { "_id" : 1, "date" : ISODate("2019-06-23"), "tempsC" : [ 4, 12, 17 ] },
      { "_id" : 2, "date" : ISODate("2019-07-07"), "tempsC" : [ 14, 24, 11 ] },
      { "_id" : 3, "date" : ISODate("2019-10-30"), "tempsC" : [ 18, 6, 8 ] }
-   ])
+   ] )
 
 To verify, query the collection:
 
@@ -319,8 +319,6 @@ See also the various update method pages for additional examples:
 
 - :ref:`db.collection.updateMany <updateMany-example-agg>`
 
-- :ref:`db.collection.update() <update-example-agg>`
-
 - :ref:`db.collection.findOneAndUpdate() <findOneAndUpdate-agg-pipeline>`
 
 - :ref:`db.collection.findAndModify() <findAndModify-agg-pipeline>`