DOCSP-25088-sort-update (BACKPORT) (#1978)

* DOCSP-24951 regex updates (#1771)

* DOCSP-24951-regex-updates

* DOCSP-24951-regex-updates

* DOCSP-24951-regex-updates

* DOCSP-24951-regex-updates

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

* DOCSP-24951 regex updates

* DOCSP-25088-sort-update (#1973)

* DOCSP-25088-sort-update

* DOCSP-25088-sort-update

* DOCSP-25088-sort-update

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

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

Author: jason-price-mongodb

source/reference/operator/update/sort.txt

@@ -104,7 +104,7 @@ array and then sorts all the elements of the array by the ascending
    ``quizzes``; i.e. ``{ score: 1 }`` and **not** ``{ "quizzes.score": 1}``
 
 After the update, the array elements are in order of ascending
-``score`` field.:
+``score`` field:
 
 .. code-block:: javascript
 
@@ -128,7 +128,7 @@ A collection ``students`` contains the following document:
 
    { "_id" : 2, "tests" : [  89,  70,  89,  50 ] }
 
-The following operation adds two more elements to the ``scores`` array
+The following operation adds two more elements to the ``tests`` array
 and sorts the elements:
 
 .. code-block:: javascript
@@ -138,7 +138,7 @@ and sorts the elements:
       { $push: { tests: { $each: [ 40, 60 ], $sort: 1 } } }
    )
 
-The updated document has the elements of the ``scores`` array in
+The updated document has the elements of the ``tests`` array in
 ascending order:
 
 .. code-block:: javascript
@@ -156,7 +156,7 @@ A collection ``students`` contains the following document:
 
 To update the ``tests`` field to sort its elements in descending
 order, specify the ``{ $sort: -1 }`` and specify an empty array ``[]``
-for the :update:`$each` modifier, as in the following:
+for the :update:`$each` modifier. For example:
 
 .. code-block:: javascript
 
@@ -165,8 +165,7 @@ for the :update:`$each` modifier, as in the following:
       { $push: { tests: { $each: [ ], $sort: -1 } } }
    )
 
-The result of the operation is to update the ``scores`` field to sort
-its elements in descending order:
+The example sorts the ``tests`` field values in descending order:
 
 .. code-block:: javascript
 
@@ -177,5 +176,5 @@ Use ``$sort`` with Other ``$push`` Modifiers
 
 .. include:: /includes/example-push-with-multiple-modifiers.rst
 
-The order of the modifiers is immaterial to the order in which the
-modifiers are processed. See :ref:`push-modifiers` for details.
+The order of the modifiers in the query does not change the order that
+the modifiers are applied. For details, see :ref:`push-modifiers`.