(DOCS-16478): persistedChunkCacheUpdateMaxBatchSize parameter (#5270) (#5347) (#5850)

* (DOCS-16394): persistedChunkCacheUpdateMaxBatchSize parameter (#5270)

* (DOCS-16394): persistedChunkCacheUpdateMaxBatchSize parameter

* add example

* update version list

* add 7.2 to release notes toc

* address review comments

* edits

* minimalism

* tweak

* wording

* address review comments

* Adjust version numbers

Author: jeff-allen-mongo

source/reference/parameters.txt

@@ -102,7 +102,7 @@ Authentication Parameters
    <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html>`__ or `AWS IAM environment variables
    <https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html#envvars-list>`__.
 
-   Maximim number of AWS IAM authentication retries after a connection 
+   Maximum number of AWS IAM authentication retries after a connection 
    failure.
 
    The following example sets :parameter:`awsSTSRetryCount` to ``15`` 
@@ -4233,6 +4233,47 @@ Sharding Parameters
 
       db.adminCommand( { setParameter: 1, orphanCleanupDelaySecs: 1200 } )
 
+.. parameter:: persistedChunkCacheUpdateMaxBatchSize
+
+   .. versionadded:: 6.0.13 (and 5.0.25)
+
+   |mongod-only|
+
+   Type: Integer
+
+   Default: 1000
+
+   To route and serve operations, shards must know the routing and
+   ownership information associated with their collections. This
+   information propogates from a shard's primary node to its
+   secondary nodes through the replication of the internal cache
+   collections ``config.cache.collections`` and
+   ``config.cache.chunks.<collectionName>``.
+   
+   In previous versions, updates on the chunk cache collection were
+   performed individually (meaning that an entry was deleted and a new
+   entry was inserted). Starting in MongoDB 7.1.1, these updates are
+   performed as a batch of deletions followed by a batch of insertions.
+   The updated logic improves performance for collections that contain a
+   large number of chunks.
+
+   The ``persistedChunkCacheUpdateMaxBatchSize`` parameter specifies the
+   maximum batch size used for updating the persisted chunk cache.
+
+   The following example sets ``persistedChunkCacheUpdateMaxBatchSize``
+   to 700 at startup:
+
+   .. code-block:: bash
+
+      mongod --setParameter persistedChunkCacheUpdateMaxBatchSize=700
+
+   You can also set ``persistedChunkCacheUpdateMaxBatchSize`` during
+   runtime:
+
+   .. code-block:: javascript
+
+      db.adminCommand( { setParameter: 1, persistedChunkCacheUpdateMaxBatchSize: 700 } )
+
 .. parameter:: rangeDeleterBatchDelayMS
 
    |mongod-only|