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

* 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

@@ -108,7 +108,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
 
@@ -132,7 +132,7 @@ Add the following document to the ``students`` collection:
 
    db.students.insertOne( { "_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
@@ -142,7 +142,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
@@ -160,7 +160,7 @@ Add the following document to the ``students`` collection:
 
 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
 
@@ -169,8 +169,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
 
@@ -181,6 +180,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`.