wip

Author: mongoKart

source/fundamentals/crud/write-operations/update.txt

@@ -93,7 +93,7 @@ methods all accept the following parameters:
    * - ``cancellationToken``
      - *Optional.* A token that you can use to cancel the operation.
 
-       **Data type**: `CancellationToken <https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken>`__
+       **Data type**: ``CancellationToken``
 
 Update Multiple Values
 ----------------------
@@ -102,8 +102,8 @@ The ``UpdateOne()``, ``UpdateOneAsync()``, ``UpdateMany()``, and ``UpdateManyAsy
 methods each accept only one ``UpdateDefinition`` object. The following sections describe how
 to update multiple values in a single method call.
 
-Combine Update Definitions
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Combined Update Definitions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The ``Builders.Update.Combine()`` method lets you combine multiple ``UpdateDefinition``
 objects. This method accepts the following parameter:
@@ -190,7 +190,7 @@ accepts the following parameter:
    * - ``pipeline``
      - A ``PipelineDefinition`` instance that represents the update pipeline. To create
        a ``PipelineDefinition`` object, create a BSON document for each update operation you
-       want to perform, then pass these documents to the ``Pipeline.Create()`` method.
+       want to perform, then pass these documents to the ``PipelineDefinition.Create()`` method.
 
        **Data Type:** ``PipelineDefinition<TDocument, TDocument>``
 
@@ -199,7 +199,7 @@ multiple aggregation stages.
 
 The following code example uses the ``Pipeline()`` method to combine a
 :manual:`$set </reference/operator/update/set/#mongodb-update-up.-set>` operation and an
-:manual:`$unset </reference/operator/update/pop/#mongodb-update-up.-unset>`
+:manual:`$unset </reference/operator/update/unset/#mongodb-update-up.-unset>`
 operation:
 
 .. tabs::
@@ -254,11 +254,11 @@ operation:
 
 .. _csharp-update-options:
 
-Customize the Update Operation
-------------------------------
+Configuration Options
+---------------------
 
 The update methods optionally accept an ``UpdateOptions`` object as a
-parameter. You can use this argument to customize the update operation.
+parameter. You can use this argument to configure the update operation.
 
 The ``UpdateOptions`` class contains the following properties:
 

source/fundamentals/crud/write-operations/update/arrays.txt

@@ -23,7 +23,8 @@ Overview
 On this page, you can learn how to use the {+driver-long+} to update array
 fields in MongoDB documents. This page describes how to create ``UpdateDefinition<TDocument>``
 objects that specify the update operations you want to perform on array fields.
-You can pass these objects to the update methods described on *this page.*
+You can pass these objects to the update methods described on the
+:ref:`<csharp-update-documents>` page.
 
 The {+driver-short+} supports the array update operators and modifiers described in the
 :manual:`{+mdb-server+} manual </reference/operator/update/#array>`.
@@ -325,17 +326,17 @@ To update all array elements that match your query filter, use the all positiona
 The following code example queries the ``restaurants`` collection for a document
 that contains a grade of 2. It then updates that grade to 22 in the matching documents.
 
-
-Updating Documents with LINQ3
------------------------------
+LINQ3 Provider
+~~~~~~~~~~~~~~
 
 LINQ syntax contains a positional operator (``$``) that you can use to update elements in an array field.
 Previous versions of the {+driver-short+} supported both the LINQ2 and LINQ3 providers.
 In LINQ2, you could use ``-1`` to indicate use of the positional operator.
 
 For example, the ``Restaurant`` class contains an array field named ``Grades`` that
-contains multiple ``GradeEntry`` elements. The following code sample uses LINQ2 to update the
-``Grade`` field of the first element in the ``Grades`` array:
+contains multiple ``GradeEntry`` elements. If your application were using the LINQ2
+provider, you could use the following code sample to update the
+``Grade`` field of the first element in this array:
 
 .. code-block:: csharp
    :linenos:
@@ -372,29 +373,3 @@ contains multiple ``GradeEntry`` elements. The following code sample uses LINQ2
       Builders<Restaurant>.Update.Set(l => l.AnArrayMember.ElementAt(-1).Deleted, true));
 
 This no longer works in LINQ3. Instead, you must use the following syntax:
-
-.. list-table::
-   :widths: 30 70
-   :header-rows: 1
-
-   * - Elements to Match
-   * - LINQ Syntax
-     - {+driver-short+} Syntax
-
-   * - First matching element
-   * - ``array.$``
-     - | Specifies the positional operator in LINQ3. 
-         See :manual:`the MongoDB server manual</reference/operator/update/positional>`
-         for more information.
-   
-   * - All elements
-   * - ``array.$[]``
-     - | Specifies the positional operator in LINQ3. 
-         See :manual:`the MongoDB server manual</reference/operator/update/positional>`
-         for more information.
-   
-   * - All matching elements
-   * - ``array.$[<identifier>]``
-     - | Specifies the positional operator in LINQ3. 
-         See :manual:`the MongoDB server manual</reference/operator/update/positional>`
-         for more information.

source/fundamentals/crud/write-operations/update/fields.txt

@@ -23,7 +23,8 @@ Overview
 On this page, you can learn how to use the {+driver-long+} to update
 fields in MongoDB documents. This page describes how to create ``UpdateDefinition<TDocument>``
 objects that specify the update operations you want to perform on fields.
-You can pass these objects to the update methods described on *this page.*
+You can pass these objects to the update methods described on the
+:ref:`<csharp-update-documents>` page.
 
 The {+driver-short+} supports the field update operators described in the
 :manual:`{+mdb-server+} manual </reference/operator/update/#fields>`. To specify an