FP tech review 1

Author: rustagir

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

@@ -184,10 +184,12 @@ The ``ReplaceOptions`` class contains the following properties:
        **Data Type:** ``bool``
 
    * - ``Sort``
-     - Specifies a sort order to apply to documents before the server
-       performs the replace operation. To set this option, you must
-       instantiate a ``ReplaceOptions<T>`` instance that uses a generic
-       type that models your data, as shown in the following code:
+     - Determines which document the operation replaces if the query
+       selects multiple documents, because the replace operation replaces
+       the first document in the sort order specified. To set this
+       option, you must instantiate an ``ReplaceOptions<T>`` instance
+       that uses a generic type that models your data, as shown in the
+       following code:
 
        .. code-block:: csharp
 

source/includes/page-templates/update/update.rst

@@ -193,10 +193,12 @@ The ``UpdateOptions`` class contains the following properties:
        **Data Type:** ``bool``
 
    * - ``Sort``
-     - Specifies a sort order to apply to documents before the server
-       performs the update operation. To set this option, you must
-       instantiate an ``UpdateOptions<T>`` instance that uses a generic
-       type that models your data, as shown in the following code:
+     - Determines which document the operation updates if the query
+       selects multiple documents, because the update operation updates
+       the first document in the sort order specified. To set this
+       option, you must instantiate an ``UpdateOptions<T>`` instance
+       that uses a generic type that models your data, as shown in the
+       following code:
 
        .. code-block:: csharp