edits

Author: lindseymoore

snooty.toml

@@ -3,6 +3,7 @@ title = "Go Driver"
 toc_landing_pages = [
     "/connect",
     "/crud",
+    "/crud/update",
     "/monitoring-and-logging",
     "/security",
     "/security/authentication",

source/crud/update.txt

@@ -29,13 +29,11 @@ Update Documents
 Overview
 --------
 
-In this guide, you can learn how to modify documents in MongoDB using
-**update** and **replace** operations.
+In this guide, you can learn how to update documents in MongoDB using
+**update** operations.
 
 Update operations change the fields that you specify while leaving other
-fields and values unchanged. Replace operations remove all existing fields
-except for ``_id`` in a document and substitute the deleted fields with
-the new fields and values you specify.
+fields and values unchanged.
 
 In MongoDB, all methods to modify documents follow the same pattern:
 
@@ -52,23 +50,19 @@ The pattern expects you to:
 * Specify the field and value changes.
 * Specify options, if you must modify the method behavior.
 
-The driver provides the following methods to modify documents:
+The driver provides the following methods to update documents:
 
 * ``UpdateByID()``
 * ``UpdateOne()``
 * ``UpdateMany()``
-* ``ReplaceOne()``
-* ``BulkWrite()`` *(not discussed in this guide)*
-* ``FindOneAndUpdate()`` *(not discussed in this guide)*
-* ``FindOneAndReplace()`` *(not discussed in this guide)*
 
 A Note About ``_id``
 ~~~~~~~~~~~~~~~~~~~~
 
 Each document in a MongoDB collection has a unique and immutable ``_id``
-field. You cannot use update and replace operations to change the
-``_id`` field. If you attempt to change this field, the update and
-replace methods return a ``WriteError``.
+field. You cannot use update operations to change the
+``_id`` field. If you attempt to change this field, the update
+methods return a ``WriteError``.
 
 .. _golang-update-documents:
 
@@ -151,7 +145,7 @@ See our :ref:`upsert guide <golang-upsert-guide>`
 to learn how to insert a new document if no documents match the query filter.
 
 UpdateOne() Example
--------------------
+~~~~~~~~~~~~~~~~~~~
 
 The following document describes an employee:
 
@@ -210,7 +204,7 @@ The following shows the updated document resulting from the preceding update ope
    }
 
 UpdateMany() Example
---------------------
+~~~~~~~~~~~~~~~~~~~~
 
 The following example uses the ``listingsAndReviews`` collection in the 
 ``sample_airbnb`` dataset from the :atlas:`Atlas sample datasets </sample-data>`.
@@ -242,121 +236,14 @@ documents in the ``listingsAndReviews`` collection:
 
 For an example on how to find multiple documents, see :ref:`golang-find-example`.
 
-.. _golang-replacement-document:
-
-Replace
--------
-
-Use the ``ReplaceOne()`` method to replace a single document.
-
-Parameters
-~~~~~~~~~~
-
-``ReplaceOne()`` expects a **replacement document**, which is the document
-that you want to take the place of an existing document. Replacement
-documents use the following format:
-
-.. code-block:: go
-
-   bson.D{{"<field>", "<value>"}, {"<field>", "<value>"}, ... }
-
-Return Values
-~~~~~~~~~~~~~
-
-``ReplaceOne()`` returns an ``UpdateResult`` type that
-contains information about the replace operation if the operation is
-successful. The ``UpdateResult`` type contains the following properties:
-
-.. list-table::
-   :widths: 30 70
-   :header-rows: 1
-
-   * - Property
-     - Description
-
-   * - ``MatchedCount`` 
-     - The number of documents matched by the filter
-
-   * - ``ModifiedCount`` 
-     - The number of documents modified by the operation
-
-   * - ``UpsertedCount`` 
-     - The number of documents upserted by the operation
-
-   * - ``UpsertedID`` 
-     - The ``_id`` of the upserted document, or ``nil`` if there is none
-
-If multiple documents match the query filter passed to ``ReplaceOne()``,
-the method selects and replaces the first matched document. Your replace
-operation fails if no documents match the query filter.
-
-Example
-```````
-
-The following document describes a kitchen item:
-
-.. code-block:: json
-   :copyable: false
-
-   {
-      "_id" : 2056,
-      "item" : "Mug",
-      "brand" : "Simply Ceramics",
-      "price" : 2.99,
-      "material" : "Glass"
-   }
-
-The following example uses the ``ReplaceOne()`` method to substitute
-this document with one that contains an ``item`` field with a
-value of "Cup" and a ``quantity`` field with a value of 107:
-
-.. io-code-block::
-   :copyable: true
-
-   .. input::
-      :language: go
-
-      filter := bson.D{{"_id", 2056}}
-      replacement := bson.D{{"item", "Cup"}, {"quantity", 107}}
-
-      result, err := collection.ReplaceOne(context.TODO(), filter, replacement)
-      fmt.Printf("Documents matched: %v\n", result.MatchedCount)
-      fmt.Printf("Documents replaced: %v\n", result.ModifiedCount)
-
-   .. output::
-      :language: none
-      :visible: false
-
-      Documents matched: 1
-      Documents replaced: 1
-
-The replaced document contains the contents of the replacement document
-and the immutable ``_id`` field as follows:
-
-.. code-block:: json
-   :copyable: false
-
-   {
-      "_id" : 2056,
-      "item" : "Cup",
-      "quantity" : 107
-   }
-
 Additional Information
 ----------------------
 
-For runnable examples of the update and replace operations, see the
-following usage examples:
-
-- :ref:`golang-update-one`
-- :ref:`golang-update-many`
-- :ref:`golang-replacement-document`
-
 To learn more about the operations mentioned, see the following
 guides:
 
 - :ref:`golang-query-document`
-- :ref:`golang-upsert`
+- :ref:`golang-retrieve`
 - :ref:`golang-compound-operations`
 - :manual:`Update Operators </reference/operator/update/#update-operators>`
 
@@ -373,4 +260,3 @@ guide, see the following API Documentation:
 - `UpdateByID() <{+api+}/mongo#Collection.UpdateByID>`__
 - `UpdateMany() <{+api+}/mongo#Collection.UpdateMany>`__
 - `UpdateResult <{+api+}/mongo#UpdateResult>`__
-- `ReplaceOne() <{+api+}/mongo#Collection.ReplaceOne>`__