DOCS-16061 update-command-upsert-issue (#3073) (#3075)

* DOCS-16061-update-command-upsert-issue

* DOCS-16061-update-command-upsert-issue

* DOCS-16061-update-command-upsert-issue

---------

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/includes/fact-upsert-id.rst

@@ -17,6 +17,12 @@ result in an error when constructing the document to insert.
 
 .. code-block:: javascript
 
-   db.collection.update( { "_id.name": "Robert Frost", "_id.uid": 0 },
-      { "categories": ["poet", "playwright"] },
-      { upsert: true } )
+   db.collection.update(
+      { "_id.name": "Robert Frost", "_id.uid": 0 },  // Query parameter
+      { $set:
+         {
+            "categories": [ "poet", "playwright" ]  // Replacement document
+         }
+      },
+      { upsert: true }  // Options
+   )

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

@@ -740,13 +740,13 @@ with :method:`~db.collection.update()`.
          :emphasize-lines: 8
 
          db.books.update(
-            { item: "ZZZ135" },   // Query parameter
-            {                     // Replacement document
-              item: "ZZZ135",
-              stock: 5,
-              tags: [ "database" ]
+            { item: "ZZZ135" },  // Query parameter
+            { $set:
+               {
+                  item: "ZZZ135", stock: 5, tags: [ "database" ]  // Replacement document
+               }
             },
-            { upsert: true }      // Options
+            { upsert: true }  // Options
          )
 
       If no document matches the ``<query>`` parameter, the update
@@ -1248,7 +1248,7 @@ collection with the following documents:
           { "grade" : 85, "mean" : 90, "std" : 4 },
           { "grade" : 85, "mean" : 85, "std" : 6 }
        ]
-     }
+     },
      {
         "_id" : 2,
         "grades" : [
@@ -1303,12 +1303,12 @@ Specify ``hint`` for Update Operations
 
 .. versionadded:: 4.2
 
-In :binary:`~bin.mongosh`, create a ``members``
+In :binary:`~bin.mongosh`, create a ``newMembers``
 collection with the following documents:
 
 .. code-block:: javascript
 
-   db.members.insertMany( [
+   db.newMembers.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 },
@@ -1321,8 +1321,8 @@ Create the following indexes on the collection:
 
 .. code-block:: javascript
 
-   db.members.createIndex( { status: 1 } )
-   db.members.createIndex( { points: 1 } )
+   db.newMembers.createIndex( { status: 1 } )
+   db.newMembers.createIndex( { points: 1 } )
 
 The following update operation explicitly :ref:`hints <update-hint>` to
 use the index ``{status: 1 }``:
@@ -1333,7 +1333,7 @@ use the index ``{status: 1 }``:
 
 .. code-block:: javascript
 
-   db.members.update(
+   db.newMembers.update(
       { points: { $lte: 20 }, status: "P" },     // Query parameter
       { $set: { misc1: "Need to activate" } },   // Update document
       { multi: true, hint: { status: 1 } }       // Options
@@ -1349,7 +1349,7 @@ To see the index used, run :dbcommand:`explain` on the operation:
 
 .. code-block:: javascript
 
-   db.members.explain().update(
+   db.newMembers.explain().update(
       { "points": { $lte: 20 }, "status": "P" },
       { $set: { "misc1": "Need to activate" } },
       { multi: true, hint: { status: 1 } }
@@ -1428,7 +1428,7 @@ option and sets ``multi`` to ``true`` to update all matching documents:
         collation: { locale: "fr", strength: 1 },
         multi: true
       }
-   );
+   )
 
 The :ref:`write result <writeresults-update>` of the operation returns the following document, indicating that all three documents in the
 collection were updated: