Docsp 31130 - batch partitions (#166)

Author: mongoKart

source/configuration/read.txt

@@ -295,9 +295,7 @@ Change Streams
 .. note::
 
    If you use ``SparkConf`` to set the connector's change stream
-   configurations, prefix ``spark.mongodb.change.stream.`` to each
-
-   property.
+   configurations, prefix ``spark.mongodb.`` to each property.
 
 .. list-table::
    :header-rows: 1
@@ -318,14 +316,14 @@ Change Streams
        original document and updated document as well as a copy of the
        entire updated document.
 
+       **Default:** "default"
+
        .. tip::
 
           For more information on how this change stream option works,
           see the MongoDB server manual guide
           :manual:`Lookup Full Document for Update Operation </changeStreams/#lookup-full-document-for-update-operations>`.
 
-       **Default:** "default"
-
    * - ``change.stream.publish.full.document.only``
      - | Specifies whether to publish the changed document or the full
          change stream document.
@@ -338,14 +336,26 @@ Change Streams
        - If you don't specify a schema, the connector infers the schema
          from the change stream document rather than from the underlying collection.
 
+         **Default**: ``false``
+       
        .. note::
 
           This setting overrides the ``change.stream.lookup.full.document``
           setting.
 
+   * - ``change.stream.micro.batch.max.partition.count``
+     - | The maximum number of partitions the {+connector-short+} divides each 
+         micro-batch into. Spark workers can process these partitions in parallel.
+       |  
+       | This setting applies only when using micro-batch streams.
        |
-       | **Default**: ``false``
+       | **Default**: ``1``
+
+       .. warning:: Event Order
 
+          Specifying a value larger than ``1`` can alter the order in which
+          the {+connector-short+} processes change events. Avoid this setting
+          if out-of-order processing could create data inconsistencies downstream. 
 
 .. _configure-input-uri: