docs(partialUpdate): add note about multiple operations (generated)

algolia/api-clients-automation#4721

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Matthieu Dumont <[email protected]>

Author: algolia-bot

algoliasearch/src/main/java/com/algolia/api/SearchClient.java

@@ -3741,8 +3741,9 @@ public CompletableFuture<UpdatedAtResponse> operationIndexAsync(
    * IncrementSet value greater than 0. You can specify an operation by providing an object with the
    * attribute to update as the key and its value being an object with the following properties: -
    * _operation: the operation to apply on the attribute - value: the right-hand side argument to
-   * the operation, for example, increment or decrement step, value to add or remove. This operation
-   * is subject to [indexing rate
+   * the operation, for example, increment or decrement step, value to add or remove. When updating
+   * multiple attributes or using multiple operations targeting the same record, you should use a
+   * single partial update for faster processing. This operation is subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -3787,8 +3788,9 @@ public UpdatedAtWithObjectIdResponse partialUpdateObject(
    * IncrementSet value greater than 0. You can specify an operation by providing an object with the
    * attribute to update as the key and its value being an object with the following properties: -
    * _operation: the operation to apply on the attribute - value: the right-hand side argument to
-   * the operation, for example, increment or decrement step, value to add or remove. This operation
-   * is subject to [indexing rate
+   * the operation, for example, increment or decrement step, value to add or remove. When updating
+   * multiple attributes or using multiple operations targeting the same record, you should use a
+   * single partial update for faster processing. This operation is subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -3830,8 +3832,9 @@ public UpdatedAtWithObjectIdResponse partialUpdateObject(
    * IncrementSet value greater than 0. You can specify an operation by providing an object with the
    * attribute to update as the key and its value being an object with the following properties: -
    * _operation: the operation to apply on the attribute - value: the right-hand side argument to
-   * the operation, for example, increment or decrement step, value to add or remove. This operation
-   * is subject to [indexing rate
+   * the operation, for example, increment or decrement step, value to add or remove. When updating
+   * multiple attributes or using multiple operations targeting the same record, you should use a
+   * single partial update for faster processing. This operation is subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -3873,8 +3876,9 @@ public UpdatedAtWithObjectIdResponse partialUpdateObject(
    * IncrementSet value greater than 0. You can specify an operation by providing an object with the
    * attribute to update as the key and its value being an object with the following properties: -
    * _operation: the operation to apply on the attribute - value: the right-hand side argument to
-   * the operation, for example, increment or decrement step, value to add or remove. This operation
-   * is subject to [indexing rate
+   * the operation, for example, increment or decrement step, value to add or remove. When updating
+   * multiple attributes or using multiple operations targeting the same record, you should use a
+   * single partial update for faster processing. This operation is subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -3914,7 +3918,9 @@ public UpdatedAtWithObjectIdResponse partialUpdateObject(
    * providing an object with the attribute to update as the key and its value being an object with
    * the following properties: - _operation: the operation to apply on the attribute - value: the
    * right-hand side argument to the operation, for example, increment or decrement step, value to
-   * add or remove. This operation is subject to [indexing rate
+   * add or remove. When updating multiple attributes or using multiple operations targeting the
+   * same record, you should use a single partial update for faster processing. This operation is
+   * subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -3972,7 +3978,9 @@ public CompletableFuture<UpdatedAtWithObjectIdResponse> partialUpdateObjectAsync
    * providing an object with the attribute to update as the key and its value being an object with
    * the following properties: - _operation: the operation to apply on the attribute - value: the
    * right-hand side argument to the operation, for example, increment or decrement step, value to
-   * add or remove. This operation is subject to [indexing rate
+   * add or remove. When updating multiple attributes or using multiple operations targeting the
+   * same record, you should use a single partial update for faster processing. This operation is
+   * subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -4015,7 +4023,9 @@ public CompletableFuture<UpdatedAtWithObjectIdResponse> partialUpdateObjectAsync
    * providing an object with the attribute to update as the key and its value being an object with
    * the following properties: - _operation: the operation to apply on the attribute - value: the
    * right-hand side argument to the operation, for example, increment or decrement step, value to
-   * add or remove. This operation is subject to [indexing rate
+   * add or remove. When updating multiple attributes or using multiple operations targeting the
+   * same record, you should use a single partial update for faster processing. This operation is
+   * subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)
@@ -4058,7 +4068,9 @@ public CompletableFuture<UpdatedAtWithObjectIdResponse> partialUpdateObjectAsync
    * providing an object with the attribute to update as the key and its value being an object with
    * the following properties: - _operation: the operation to apply on the attribute - value: the
    * right-hand side argument to the operation, for example, increment or decrement step, value to
-   * add or remove. This operation is subject to [indexing rate
+   * add or remove. When updating multiple attributes or using multiple operations targeting the
+   * same record, you should use a single partial update for faster processing. This operation is
+   * subject to [indexing rate
    * limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
    *
    * @param indexName Name of the index on which to perform the operation. (required)