DOCSP-17645-multi-delete (#1677)

* DOCSP-17645-multi-delete

* DOCSP-17645-multi-delete

* DOCSP-17645-multi-delete

* DOCSP-17645-multi-delete

* DOCSP-17645-multi-delete

* DOCSP-17645-multi-delete

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

Author: jason-price-mongodb

source/core/index-ttl.txt

@@ -141,6 +141,8 @@ When the TTL thread is active, you will see delete operations in the
 output of :method:`db.currentOp()` or in the data collected by the
 :ref:`database profiler <database-profiler>`.
 
+.. include:: /includes/multi-deletes.rst
+
 Timing of the Delete Operation
 ``````````````````````````````
 

source/includes/multi-deletes.rst

@@ -0,0 +1,6 @@
+Starting in MongoDB 6.1:
+
+- To improve efficiency, MongoDB may batch multiple document deletions
+  together.
+- The :dbcommand:`explain` command :ref:`results <explain-results>`
+  contain a new ``BATCHED_DELETE`` stage for batched document deletions.

source/reference/delete-methods.txt

@@ -24,6 +24,8 @@ collection:
    * - :method:`db.collection.remove()`
      - Delete a single document or all documents that match a specified filter.
 
+.. include:: /includes/multi-deletes.rst
+
 .. _additional-deletes:
 
 Additional Methods

source/reference/explain-results.txt

@@ -111,6 +111,9 @@ Stages are descriptive of the operation. For example:
 
 - ``SHARDING_FILTER`` for filtering out orphan documents from shards
 
+- ``BATCHED_DELETE`` for multiple document deletions that are batched
+  together internally (starting in MongoDB 6.1)
+
 .. _explain-results-5.1-later:
 
 Explain Output for MongoDB 5.1 and Later

source/release-notes/6.1.txt

@@ -51,6 +51,11 @@ For an example that uses the ``*UCP`` option, see
 General Changes
 ---------------
 
+Improved Efficiency for Multiple Document Deletions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/multi-deletes.rst
+
 ``connPoolStats`` Metrics
 ~~~~~~~~~~~~~~~~~~~~~~~~~