DOCS-11241 - Updating compatibility notes for sorting on multiple array fields

Author: jeff-allen-mongo

source/release-notes/3.6-compatibility.txt

@@ -249,10 +249,11 @@ Sorting with a Compound Sort Pattern on Multiple Array Fields with ``aggregate``
 
 In MongoDB 3.6, when sorting in an
 :doc:`aggregation pipeline </core/aggregation-pipeline/>`, MongoDB can
-no longer sort with keys that are *parallel arrays*. Arrays are
-considered parallel if they are sibling elements of the BSON object.
-Sort keys involving nested arrays are not considered parallel, nor are
-sort keys which share the same array as a prefix.
+no longer sort documents which contain *parallel arrays* in the fields
+being sorted on. Arrays are considered parallel if they are sibling
+elements of the BSON object. Sort keys involving nested arrays are not
+considered parallel, nor are sort keys which share the same array as a
+prefix.
 
 .. note::
 
@@ -309,9 +310,9 @@ sort keys which share the same array as a prefix.
       db.coll.aggregate([ { $sort: {a: 1, b: 1} } ])
 
    MongoDB cannot sort on both the ``a`` and ``b`` fields because
-   in the document with ``_id : 1`` , both the ``a`` and ``b`` fields
-   are arrays. As a result, MongoDB encounters a parallel array during
-   sort key generation and returns an error.
+   in the document with ``_id : 1`` , the sibling fields ``a`` and
+   ``b`` are both arrays. As a result, MongoDB encounters a parallel
+   array during sort key generation and returns an error.
 
 Update Operation Changes
 ------------------------