docs(specs): align with style guides (generated)

algolia/api-clients-automation#5930

Co-authored-by: algolia-bot <accounts+algolia-api-client-bot@algolia.com>
Co-authored-by: Kai Welke <kai.welke@algolia.com>

Author: algolia-bot

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

@@ -2986,13 +2986,13 @@ public CompletableFuture<Response> searchForFacetValuesWithHTTPInfoAsync(@Nonnul
   }
 
   /**
-   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint allows you to
-   * create a new sorting strategy mapping or replace the currently configured one. The provided
-   * sorting indices MUST be associated indices or replicas of the main targeted index. WARNING:
-   * This endpoint cannot validate if the sort index is related to the composition's main index.
-   * Validation will fail at runtime if the index you updated is not related! The update is applied
-   * to the specified composition within the current Algolia application and returns a taskID that
-   * can be used to track the operation’s completion.
+   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint lets you create
+   * a new sorting strategy mapping or replace the configured one. The provided sorting indices must
+   * be associated indices or replicas of the main targeted index. This endpoint can't validate
+   * whether the sort index is related to the composition's main index. Validation fails at runtime
+   * if the index you updated isn't related. The update is applied to the specified composition
+   * within the current Algolia application and returns a taskID that can be used to track the
+   * operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3009,13 +3009,13 @@ public TaskIDResponse updateSortingStrategyComposition(
   }
 
   /**
-   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint allows you to
-   * create a new sorting strategy mapping or replace the currently configured one. The provided
-   * sorting indices MUST be associated indices or replicas of the main targeted index. WARNING:
-   * This endpoint cannot validate if the sort index is related to the composition's main index.
-   * Validation will fail at runtime if the index you updated is not related! The update is applied
-   * to the specified composition within the current Algolia application and returns a taskID that
-   * can be used to track the operation’s completion.
+   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint lets you create
+   * a new sorting strategy mapping or replace the configured one. The provided sorting indices must
+   * be associated indices or replicas of the main targeted index. This endpoint can't validate
+   * whether the sort index is related to the composition's main index. Validation fails at runtime
+   * if the index you updated isn't related. The update is applied to the specified composition
+   * within the current Algolia application and returns a taskID that can be used to track the
+   * operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3032,13 +3032,13 @@ public Response updateSortingStrategyCompositionWithHTTPInfo(
   }
 
   /**
-   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint allows you to
-   * create a new sorting strategy mapping or replace the currently configured one. The provided
-   * sorting indices MUST be associated indices or replicas of the main targeted index. WARNING:
-   * This endpoint cannot validate if the sort index is related to the composition's main index.
-   * Validation will fail at runtime if the index you updated is not related! The update is applied
-   * to the specified composition within the current Algolia application and returns a taskID that
-   * can be used to track the operation’s completion.
+   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint lets you create
+   * a new sorting strategy mapping or replace the configured one. The provided sorting indices must
+   * be associated indices or replicas of the main targeted index. This endpoint can't validate
+   * whether the sort index is related to the composition's main index. Validation fails at runtime
+   * if the index you updated isn't related. The update is applied to the specified composition
+   * within the current Algolia application and returns a taskID that can be used to track the
+   * operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3050,13 +3050,13 @@ public TaskIDResponse updateSortingStrategyComposition(@Nonnull String compositi
   }
 
   /**
-   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint allows you to
-   * create a new sorting strategy mapping or replace the currently configured one. The provided
-   * sorting indices MUST be associated indices or replicas of the main targeted index. WARNING:
-   * This endpoint cannot validate if the sort index is related to the composition's main index.
-   * Validation will fail at runtime if the index you updated is not related! The update is applied
-   * to the specified composition within the current Algolia application and returns a taskID that
-   * can be used to track the operation’s completion.
+   * Updates the \"sortingStrategy\" field of an existing composition. This endpoint lets you create
+   * a new sorting strategy mapping or replace the configured one. The provided sorting indices must
+   * be associated indices or replicas of the main targeted index. This endpoint can't validate
+   * whether the sort index is related to the composition's main index. Validation fails at runtime
+   * if the index you updated isn't related. The update is applied to the specified composition
+   * within the current Algolia application and returns a taskID that can be used to track the
+   * operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3069,12 +3069,12 @@ public Response updateSortingStrategyCompositionWithHTTPInfo(@Nonnull String com
 
   /**
    * (asynchronously) Updates the \"sortingStrategy\" field of an existing composition. This
-   * endpoint allows you to create a new sorting strategy mapping or replace the currently
-   * configured one. The provided sorting indices MUST be associated indices or replicas of the main
-   * targeted index. WARNING: This endpoint cannot validate if the sort index is related to the
-   * composition's main index. Validation will fail at runtime if the index you updated is not
-   * related! The update is applied to the specified composition within the current Algolia
-   * application and returns a taskID that can be used to track the operation’s completion.
+   * endpoint lets you create a new sorting strategy mapping or replace the configured one. The
+   * provided sorting indices must be associated indices or replicas of the main targeted index.
+   * This endpoint can't validate whether the sort index is related to the composition's main index.
+   * Validation fails at runtime if the index you updated isn't related. The update is applied to
+   * the specified composition within the current Algolia application and returns a taskID that can
+   * be used to track the operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3101,12 +3101,12 @@ public CompletableFuture<TaskIDResponse> updateSortingStrategyCompositionAsync(
 
   /**
    * (asynchronously) Updates the \"sortingStrategy\" field of an existing composition. This
-   * endpoint allows you to create a new sorting strategy mapping or replace the currently
-   * configured one. The provided sorting indices MUST be associated indices or replicas of the main
-   * targeted index. WARNING: This endpoint cannot validate if the sort index is related to the
-   * composition's main index. Validation will fail at runtime if the index you updated is not
-   * related! The update is applied to the specified composition within the current Algolia
-   * application and returns a taskID that can be used to track the operation’s completion.
+   * endpoint lets you create a new sorting strategy mapping or replace the configured one. The
+   * provided sorting indices must be associated indices or replicas of the main targeted index.
+   * This endpoint can't validate whether the sort index is related to the composition's main index.
+   * Validation fails at runtime if the index you updated isn't related. The update is applied to
+   * the specified composition within the current Algolia application and returns a taskID that can
+   * be used to track the operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3133,12 +3133,12 @@ public CompletableFuture<Response> updateSortingStrategyCompositionWithHTTPInfoA
 
   /**
    * (asynchronously) Updates the \"sortingStrategy\" field of an existing composition. This
-   * endpoint allows you to create a new sorting strategy mapping or replace the currently
-   * configured one. The provided sorting indices MUST be associated indices or replicas of the main
-   * targeted index. WARNING: This endpoint cannot validate if the sort index is related to the
-   * composition's main index. Validation will fail at runtime if the index you updated is not
-   * related! The update is applied to the specified composition within the current Algolia
-   * application and returns a taskID that can be used to track the operation’s completion.
+   * endpoint lets you create a new sorting strategy mapping or replace the configured one. The
+   * provided sorting indices must be associated indices or replicas of the main targeted index.
+   * This endpoint can't validate whether the sort index is related to the composition's main index.
+   * Validation fails at runtime if the index you updated isn't related. The update is applied to
+   * the specified composition within the current Algolia application and returns a taskID that can
+   * be used to track the operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)
@@ -3153,12 +3153,12 @@ public CompletableFuture<TaskIDResponse> updateSortingStrategyCompositionAsync(
 
   /**
    * (asynchronously) Updates the \"sortingStrategy\" field of an existing composition. This
-   * endpoint allows you to create a new sorting strategy mapping or replace the currently
-   * configured one. The provided sorting indices MUST be associated indices or replicas of the main
-   * targeted index. WARNING: This endpoint cannot validate if the sort index is related to the
-   * composition's main index. Validation will fail at runtime if the index you updated is not
-   * related! The update is applied to the specified composition within the current Algolia
-   * application and returns a taskID that can be used to track the operation’s completion.
+   * endpoint lets you create a new sorting strategy mapping or replace the configured one. The
+   * provided sorting indices must be associated indices or replicas of the main targeted index.
+   * This endpoint can't validate whether the sort index is related to the composition's main index.
+   * Validation fails at runtime if the index you updated isn't related. The update is applied to
+   * the specified composition within the current Algolia application and returns a taskID that can
+   * be used to track the operation’s completion.
    *
    * @param compositionID Unique Composition ObjectID. (required)
    * @param requestBody (required)