DOCSP-47834 clarify batch size (#524) (#531)

* clarify batch size

* change find

* clarify no effect

* fix wrapping

* remove extra space

* review

(cherry picked from commit 9d38c02)

Co-authored-by: shuangela <[email protected]>

Author: github-actions[bot]

source/fundamentals/crud/read-operations/change-streams.txt

@@ -210,9 +210,16 @@ of ``Watch()`` and ``WatchAsync()``:
          include expanded events in a change stream, create the change stream
          cursor and set this parameter to ``True``.
 
-   * - ``BatchSize``
-     - | Specifies the maximum number of change events to return in each batch of the
-         response from the MongoDB cluster.
+   * - ``batchSize``
+     - | Specifies the maximum number of documents that a change
+         stream can return in each batch, which applies to ``Watch()`` or
+         ``WatchAsync()``. If the ``batchSize`` option is not set, watch functions have 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 result in batches
+         larger than 16 MiB, this option has no effect and ``Watch()``
+         or ``WatchAsync()`` uses the default batch size.
 
    * - ``Collation``
      - | Specifies the collation to use for the change stream cursor.

source/fundamentals/crud/read-operations/retrieve.txt

@@ -205,7 +205,13 @@ You can configure the commonly used options with the following methods:
      - Description
 
    * - ``BatchSize`` 
-     - | Gets or sets the number of documents to hold in a cursor at a given time.
+     - | Gets or sets the maximum number of documents within each
+         batch returned in a query result. If ``batchSize`` is not set, the ``Find()``
+         method 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 and the
+         ``Find()`` method uses the default batch size.
 
    * - ``Collation`` 
      - | Sets the collation options.