Docsp 19930 update insert pt3 v5.1 (#88) (#89)

* DOCSP-19930-update-insert-pt3

* Add more files

* One more

* Staging tweaks

* Feedback comments

Author: Dave

source/includes/fact-bulkwrite-explainable.rst

@@ -3,4 +3,3 @@
 
 .. end-explainable
 
-Use |old-write-method| instead.

source/reference/command/update.txt

@@ -4,8 +4,6 @@ update
 
 .. default-domain:: mongodb
 
-
-
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -25,11 +23,8 @@ Definition
    :binary:`~bin.mongosh` provides the following helper methods:
 
    - :method:`db.collection.updateOne()`
-
    - :method:`db.collection.updateMany()` 
 
-   - :method:`db.collection.update()`
-
 Syntax
 ------
 
@@ -74,65 +69,41 @@ The command takes the following fields:
    :widths: 20 20 80
 
    * - Field
-
      - Type
-
      - Description
 
    * - ``update``
-
      - string
-
      - The name of the target collection.
-       
-       
 
    * - ``updates``
-
      - array
-
      - An array of one or more update statements to perform on the named
        collection. For details of the update statements, see :ref:`Update
        Statements <update-statement-documents>`.
-       
-       
 
    * - ``ordered``
-
      - boolean
-
      - Optional. If ``true``, then when an update statement fails, return without
        performing the remaining update statements. If ``false``, then when
        an update fails, continue with the remaining update statements, if
        any. Defaults to ``true``.
-       
-       
 
    * - ``writeConcern``
-
      - document
-
      - Optional. A document expressing the :doc:`write concern </reference/write-concern>`
        of the :dbcommand:`update` command. Omit to use the default write
        concern.
 
        .. include:: /includes/extracts/transactions-operations-write-concern.rst
-       
-       
 
    * - ``bypassDocumentValidation``
-
      - boolean
-
      - Optional. Enables :dbcommand:`update` to bypass document validation
        during the operation. This lets you update documents that do not
        meet the validation requirements.
-       
-       .. versionadded:: 3.2
-       
-       
-   * - ``comment``
 
+   * - ``comment``
      - any
 
      - .. include:: /includes/extracts/comment-content.rst
@@ -141,13 +112,11 @@ The command takes the following fields:
 
 
    * - :ref:`let <update-let-syntax>`
-
      - document
-        
      - .. _update-let-syntax:
-     
+
        Optional.
-     
+
        .. include:: /includes/let-variables-syntax.rst
 
        For a complete MQL example, see :ref:`update-variables-example`.
@@ -167,50 +136,39 @@ Each document contains the following fields:
    :widths: 20 20 80
 
    * - Field
-
      - Type
-
      - Description
 
    * - :ref:`q <update-command-q>`
-
      - document
-
      - .. _update-command-q:
 
        The query that matches documents to update. Use the same :ref:`query
        selectors <query-selectors>` as used in the :method:`find()
        <db.collection.find()>` method.
 
    * - :ref:`u <update-command-u>`
-
      - document or pipeline
-
      - .. _update-command-u:
 
        The modifications to apply.
-
        The value can be either:
 
        - A document that contains :ref:`update operator expressions
          <update-operators>`,
-
        - A replacement document with only ``<field1>: <value1>`` pairs, or
-
        - Starting in MongoDB 4.2, an aggregation pipeline.
 
          .. include:: /includes/list-update-agg-stages.rst
 
        For details, see :ref:`update-command-behaviors`.
 
    * - :ref:`c <update-command-c>`
-
      - document
-
      - .. _update-command-c:
 
        Optional.
-     
+
        .. include:: /includes/let-variables-syntax.rst
 
        .. include:: /includes/let-variables-syntax-note.rst
@@ -221,17 +179,13 @@ Each document contains the following fields:
        .. versionadded:: 5.0
 
    * - :ref:`upsert <update-command-upsert>`
-
      - boolean
-
      - .. _update-command-upsert:
 
        .. include:: /includes/extracts/update-upsert-behavior-command.rst
 
    * - ``multi``
-
      - boolean
-
      - Optional. If ``true``, updates all documents that meet the query criteria. If
        ``false``, limit the update to one document that meet the query
        criteria. Defaults to ``false``.
@@ -776,11 +730,11 @@ values to calculate a separate field value.
 
 .. code-block:: javascript
 
-   db.students.insert([
+   db.students.insertMany( [
       { "_id" : 1, "tests" : [ 95, 92, 90 ] },
       { "_id" : 2, "tests" : [ 94, 88, 90 ] },
       { "_id" : 3, "tests" : [ 70, 75, 82 ] }
-   ]);
+   ] );
 
 Using an aggregation pipeline, you can update the documents with the
 calculated grade average and letter grade.
@@ -924,24 +878,24 @@ 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
 :update:`$[\<identifier\>]` with the ``arrayFilters`` option:
 
 .. code-block:: javascript
 
-   db.runCommand({
+   db.runCommand( {
       update: "students",
       updates: [
         { q: { grades: { $gte: 100 } }, u: { $set: { "grades.$[element]" : 100 } }, arrayFilters: [ { "element": { $gte: 100 } } ], multi: true}
       ]
-   })
+   } )
 
 After the operation, the collection contains the following documents:
 
@@ -959,7 +913,7 @@ Create a collection ``students2`` with the following documents:
 
 .. code-block:: javascript
 
-   db.students2.insert([
+   db.students2.insertMany( [
       {
          "_id" : 1,
          "grades" : [
@@ -976,7 +930,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``,

source/reference/config-database.txt

@@ -1,6 +1,3 @@
-
-
-
 .. _config-database:
 
 ===============
@@ -75,7 +72,7 @@ exists):
 
 .. code-block:: javascript
 
-   db.testConfigServerWriteAvail.insert( { a : 1 } )
+   db.testConfigServerWriteAvail.insertOne( { a : 1 } )
 
 If the operation succeeds, the config server is available to process
 writes.

source/reference/database-references.txt

@@ -1,6 +1,3 @@
-
-
-
 .. _database-references:
 
 ===================
@@ -92,13 +89,13 @@ document:
 
    original_id = ObjectId()
 
-   db.places.insert({
+   db.places.insertOne({
        "_id": original_id,
        "name": "Broadway Center",
        "url": "bc.example.net"
    })
 
-   db.people.insert({
+   db.people.insertOne({
        "name": "Erin",
        "places_id": original_id,
        "url":  "bc.example.net/Erin"

source/reference/insert-methods.txt

@@ -11,18 +11,12 @@ MongoDB provides the following methods for inserting :ref:`documents
    :widths: 35 65
 
    * - :method:`db.collection.insertOne()`
-
-     - Inserts a single document  into a collection.
+     - Inserts a single :ref:`document <bson-document-format>` into a
+        collection.
 
    * - :method:`db.collection.insertMany()`
-
-     - :method:`db.collection.insertMany()` inserts *multiple*
-       :ref:`documents <bson-document-format>` into a collection.
-
-   * - :method:`db.collection.insert()`
-
-     - :method:`db.collection.insert()` inserts a single document or
-       multiple documents into a collection.
+     - Inserts multiple :ref:`documents <bson-document-format>` into a
+       collection.
 
 .. _additional-inserts:
 
@@ -31,24 +25,16 @@ Additional Methods for Inserts
 
 The following methods can also add new documents to a collection:
 
-- :method:`db.collection.update()` when used with the ``upsert: true``
-  option.
-
 - :method:`db.collection.updateOne()` when used with the ``upsert:
   true`` option.
-
 - :method:`db.collection.updateMany()` when used with the ``upsert:
   true`` option.
-
 - :method:`db.collection.findAndModify()` when used with the ``upsert:
   true`` option.
-
 - :method:`db.collection.findOneAndUpdate()` when used with the
   ``upsert: true`` option.
-
 - :method:`db.collection.findOneAndReplace()` when used with the
   ``upsert: true`` option.
-
 - :method:`db.collection.bulkWrite()`.
 
 See the individual reference pages for the methods for more information

source/reference/method.txt

@@ -133,17 +133,13 @@ Collection
 
      - 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.
+     - Inserts a new document into a collection.
 
    * - :method:`db.collection.insertMany()`
 
-     - Inserts several new document in a collection.
+     - Inserts several new documents into a collection.
 
    * - :method:`db.collection.isCapped()`
 

source/reference/method/Bulk.find.hint.txt

@@ -23,9 +23,7 @@ Description
    to support the :method:`Bulk.find()` for:
 
    - :method:`Bulk.find.replaceOne()`
-
    - :method:`Bulk.find.update()`
-
    - :method:`Bulk.find.updateOne()`.
 
    The option can take an index specification document or the index
@@ -43,13 +41,13 @@ Create an example collection ``orders``:
 
 .. code-block:: javascript
 
-   db.orders.insert([
+   db.orders.insertMany( [
       { "_id" : 1, "item" : "abc", "price" : NumberDecimal("12"), "quantity" : 2, "type": "apparel" },
       { "_id" : 2, "item" : "jkl", "price" : NumberDecimal("20"), "quantity" : 1, "type": "electronics" },
       { "_id" : 3, "item" : "abc", "price" : NumberDecimal("10"), "quantity" : 5, "type": "apparel" },
       { "_id" : 4, "item" : "abc", "price" : NumberDecimal("8"), "quantity" : 10, "type": "apparel" },
       { "_id" : 5, "item" : "jkl", "price" : NumberDecimal("15"), "quantity" : 15, "type": "electronics" }
-   ])
+   ] )
 
 Create the following indexes on the example collection:
 

source/reference/method/PlanCache.list.txt

@@ -136,13 +136,13 @@ The examples in this section use the following ``orders`` collection:
 
 .. code-block:: javascript
 
-   db.orders.insert([
+   db.orders.insertMany( [
       { "_id" : 1, "item" : "abc", "price" : NumberDecimal("12"), "quantity" : 2, "type": "apparel" },
       { "_id" : 2, "item" : "jkl", "price" : NumberDecimal("20"), "quantity" : 1, "type": "electronics" },
       { "_id" : 3, "item" : "abc", "price" : NumberDecimal("10"), "quantity" : 5, "type": "apparel" },
       { "_id" : 4, "item" : "abc", "price" : NumberDecimal("8"), "quantity" : 10, "type": "apparel" },
       { "_id" : 5, "item" : "jkl", "price" : NumberDecimal("15"), "quantity" : 15, "type": "electronics" }
-   ])
+   ] )
 
 Create the following indexes on the collection: