diff --git a/source/includes/extracts-4.2-changes.yaml b/source/includes/extracts-4.2-changes.yaml index 159f8bdeb74..e2319a24d93 100644 --- a/source/includes/extracts-4.2-changes.yaml +++ b/source/includes/extracts-4.2-changes.yaml @@ -805,15 +805,14 @@ content: | Starting in MongoDB 4.2, - - Replace document operations, such as - :method:`db.collection.replaceOne()` or :ref:`db.collection.update( - query, replacement, ... ) `, - attempt to target a single shard, first by using the query filter. If the - operation cannot target a single shard by the query filter, it then - attempts to target by the replacement document. - - In earlier versions, the operation attempts to target using the - replacement document. + - Operations which replace documents, such as + :method:`~db.collection.replaceOne()` or + :method:`~db.collection.update()` (when used with a replacement + document), will first attempt to target a single shard by using the + query filter. If the operation cannot target a single shard by the + query filter, it then attempts to target by the replacement + document. In earlier versions, these operations only attempt to + target using the replacement document. - The :method:`~db.collection.save()` method is deprecated: use the :method:`~db.collection.insertOne()` or