DOCSP-47795 change batchsize descriptions

source/reference/command/find.txt

@@ -132,9 +132,14 @@ The command accepts the following fields:
 
    * - ``batchSize``
      - non-negative integer
-     - Optional. The number of documents to return in the first batch.
-       Defaults to 101. A batchSize of 0 means that the cursor will be
-       established, but no documents will be returned in the first batch.
+     - Optional. The maximum number of documents within each batch returned in a query result. 
+       By default, the ``find`` command has an initial batch size of ``101`` documents and a maximum 
+       size of 16 mebibytes (MiB) for each subsequent batch. This option can enforce a smaller
+       limit than 16 MiB, but not a larger one. If you set ``batchSize`` to a limit that results 
+       in batches larger than 16 MiB, this option has no effect.
+`
+       A batchSize of 0 means that the cursor will be established, but no documents 
+       will be returned in the first batch.
 
        Unlike the previous wire protocol version, a batchSize of 1 for
        the :dbcommand:`find` command does not close the cursor.

source/reference/command/getMore.txt

@@ -72,11 +72,12 @@ The command accepts the following fields:
 
    * - ``batchSize``
      - positive integer
-     - Optional. The number of documents to return in the batch.
+     - Optional. Specifies the maximum number of documents within each batch returned in a query result.
 
-       If ``batchSize`` is not set, ``getMore`` returns up to 16
-       mebibytes of data. If ``batchSize`` is set, ``getMore`` returns
-       the smaller of 16 mebibytes of data or ``batchSize`` documents.
+       If batchSize is not set, getMore returns up to ``101`` documents in the first batch 
+       and up to 16 mebibytes (MiB) of data in all subsequent batches. If ``batchSize`` is set, ``getMore`` returns
+       the smaller of 16 mebibytes of data or ``batchSize`` documents. If you set ``batchSize`` to a limit that results 
+       in batches larger than 16 MiB, this option has no effect.
 
    * - ``maxTimeMS``
      - non-negative integer

source/reference/method/cursor.batchSize.txt

@@ -19,12 +19,14 @@ Definition
 
    .. include:: /includes/fact-mongosh-shell-method.rst
 
-   Specifies the
-   number of documents to return in each batch of the response from the
-   MongoDB instance. In most cases, modifying the batch size will
-   not affect the user or the application, as :binary:`~bin.mongosh` and
-   most :driver:`drivers </>` return results as if MongoDB returned a
-   single batch.
+   Specifies the maximum number of documents within each batch returned in a query result. 
+   By default, the initial batch size is ``101`` documents and subsequent batches have a maximum 
+   size of 16 mebibytes (MiB). This option can enforce a smaller
+   limit than 16 MiB, but not a larger one. If you set ``batchSize`` to a limit that results 
+   in batches larger than 16 MiB, this option has no effect.
+
+   A batchSize of 0 means that the cursor will be established, but no documents 
+   will be returned in the first batch. 
 
    .. note::
 
@@ -51,9 +53,10 @@ Definition
 
       * - ``size``
         - integer
-        - The initial number of documents to return for a batch. The
-          default initial batch size is 101 documents. Subsequent
-          batches are 16 mebibytes. The default applies to drivers and
+        - The maximum number of documents to return for a batch. The
+          default initial batch size is ``101`` documents and subsequent
+          batches have a maximum size of 16 mebibytes (MiB). This option can enforce a smaller limit than
+          16 MiB, but not a larger one. The default applies to drivers and
           Mongo Shell. For details, see :ref:`cursor-batches`.
 
 Compatibility

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

@@ -115,13 +115,15 @@ Definition
       * - ``batchSize``
 
         - int
-        - Optional. Specifies the maximum number of change events to return in each
-          batch of the response from the MongoDB cluster. 
+        - Optional. The maximum number of documents within each batch returned in a change stream. 
+          By default, :method:`~db.collection.watch()` has an initial batch size of ``101`` documents and a maximum size 
+          of 16 mebibytes (MiB) for each subsequent batch. This option can enforce a smaller 
+          limit than 16 MiB, but not a larger one. If you set ``batchSize`` to a limit that
+          results in batches larger than 16 MiB, this option has no effect.
 
           Has the same functionality as :method:`cursor.batchSize()`.
 
 
-
       * - ``maxAwaitTimeMS``
 
         - int

source/reference/operator/aggregation/queryStats.txt

@@ -354,9 +354,11 @@ Each document in the output array contains the following fields:
    * - ``key.batchSize``
      - String
      - Normalized
-     - The :ref:`batch size <cursor-batchSize>` for the key. Batch size
-       specifies the number of documents to return in each batch of the
-       response from the MongoDB instance.
+     - The :ref:`batch size <cursor-batchSize>` for the key. Batch size specifies 
+       the maximum number of documents returned within each batch from the MongoDB instance. 
+       By default, the initial batch size is ``101`` documents and subsequent batches have a
+       maximum size of 16 mebibytes (MiB). ``batchSize`` can enforce a smaller limit than 
+       16 MiB, but not a larger one.
 
    * - ``key.comment``
      - String