DOCSP-27571-batch-size (#7325) (#7347)

* DOCSP-27571-batch-size

* DOCSP-27571-batch-size

* DOCSP-27571-batch-size

---------

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

Author: jason-price-mongodb

source/reference/method/cursor.batchSize.txt

@@ -17,10 +17,8 @@ Definition
 
 .. method:: cursor.batchSize(size)
 
-
    .. 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
@@ -29,34 +27,36 @@ Definition
    single batch.
 
    The :method:`~cursor.batchSize()` method takes the
-   following parameter:
-
+   following field:
 
    .. list-table::
       :header-rows: 1
       :widths: 20 20 80
 
-      * - Parameter
-   
+      * - Field
         - Type
-   
         - Description
 
       * - ``size``
-   
         - integer
-   
-        - The number of documents to return per batch.
+        - The initial number of documents to return for a batch. The
+          default initial batch size is 101 documents. Subsequent
+          batches are 16 megabytes. The default applies to drivers and
+          Mongo Shell. For details, see :ref:`cursor-batches`.
 
 Example
 -------
 
-The following example sets the batch size for the results of a query
-(i.e. :method:`~db.collection.find()`) to ``10``. The
-:method:`~cursor.batchSize()` method does not change the
-output in :binary:`~bin.mongosh`, which, by default, iterates over the
-first 20 documents.
+The following example sets ``batchSize`` for the results of a query
+(specifically, :method:`~db.collection.find()`) to ``10``:
 
 .. code-block:: javascript
 
    db.inventory.find().batchSize(10)
+
+Learn More
+----------
+
+- :ref:`cursor-batches`
+- :method:`cursor.next()`
+- :dbcommand:`getMore`