DOCS-16308 findAndModify and deleteOne partial shard key updates (#4798)

* DOCS-16308 partial shard key

* DOCS-16308 partial shard key

* DOCS-16308 update delete one

* DOCS-16308 fix method label

* DOCS-16308 updates to italicized letters

Author: jocelyn-mendez1

source/includes/fact-single-modification-in-sharded-collections.rst

@@ -1,10 +1,7 @@
-All |single-modification-operation-names| operations for a sharded
-collection that specify the |single-modification-operation-option|
-option must include the :term:`shard key` *or* the ``_id`` field in
-the query specification.
+To use |single-modification-operation-names| operations for a sharded
+collection that specify the |single-modification-operation-option| option: 
 
-|single-modification-operation-names| operations specifying
-|single-modification-operation-option| in a sharded collection which do
-not contain either the :term:`shard key` or the ``_id`` field return an
-error.
+- If you only target one shard, you can use a partial shard key in the query specification or,
 
+- You can provide the :term:`shard key` or the ``_id`` field in the query
+  specification.

source/reference/command/findAndModify.txt

@@ -329,8 +329,11 @@ Upsert with Unique Index
 Sharded Collections
 ~~~~~~~~~~~~~~~~~~~
 
-To use :dbcommand:`findAndModify` on a sharded collection, the query
-filter must include an equality condition on the shard key.
+To use :dbcommand:`findAndModify` on a sharded collection:
+
+- If you only target one shard, you can use a partial shard key in the ``query`` field or,
+
+- You can provide an equality condition on a full shard key in the ``query`` field. 
 
 .. include:: /includes/extracts/missing-shard-key-equality-condition-findAndModify.rst
 

source/reference/method/db.collection.deleteOne.txt

@@ -127,11 +127,12 @@ for precise deletions.
 Sharded Collections
 ~~~~~~~~~~~~~~~~~~~
 
-:method:`db.collection.deleteOne()` operations on a sharded collection
-must include the :term:`shard key` *or* the ``_id`` field in the query
-specification. :method:`db.collection.deleteOne()` operations in a
-sharded collection which do not contain either the :term:`shard key` or
-the ``_id`` field return an error.
+To use :method:`db.collection.deleteOne` on a sharded collection:
+
+- If you only target one shard, you can use a partial shard key in the query specification or,
+
+- You can provide the :term:`shard key` or the ``_id`` field in the query
+  specification.
 
 Transactions
 ~~~~~~~~~~~~

source/reference/method/db.collection.findAndModify.txt

@@ -266,8 +266,11 @@ Upsert with Unique Index
 Sharded Collections
 ~~~~~~~~~~~~~~~~~~~
 
-When using :dbcommand:`findAndModify` against a sharded collection, the
-``query`` **must** contain an equality condition on :term:`shard key`.
+To use :dbcommand:`findAndModify` on a sharded collection:
+
+- If you only target one shard, you can use a partial shard key in the ``query`` field or,
+
+- You can provide an equality condition on a full shard key in the ``query`` field. 
 
 .. include:: /includes/extracts/missing-shard-key-equality-condition-findAndModify.rst
 

source/release-notes/7.1.txt

@@ -85,6 +85,15 @@ MongoDB 7.1 adds the :parameter:`indexBuildMinAvailableDiskSpaceMB`
 parameter, which allows you to set the minimum available disk space
 required for index builds.
 
+Query with Partial Shard Key
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 7.1, :dbcommand:`findAndModify` and :method:`~db.collection.deleteOne()` 
+can use a partial shard key to query on a sharded collection.
+
+``serverStatus`` Output Change 
+------------------------------
+
 Specify a query's index using the hint field
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~