refactor(specs): add interface to manipulate query parameter between composition API & Search API (generated)

algolia/api-clients-automation#5123

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Clara Muller <[email protected]>
Co-authored-by: Clément Vannicatte <[email protected]>

Author: 3 people

algoliasearch/src/main/java/com/algolia/model/composition/Params.java

@@ -144,7 +144,7 @@ public Params setGetRankingInfo(Boolean getRankingInfo) {
     return this;
   }
 
-  /** Whether the search response should include detailed ranking information. */
+  /** Whether the run response should include detailed ranking information. */
   @javax.annotation.Nullable
   public Boolean getGetRankingInfo() {
     return getRankingInfo;
@@ -320,11 +320,11 @@ public Params addQueryLanguages(SupportedLanguage queryLanguagesItem) {
 
   /**
    * Languages for language-specific query processing steps such as plurals, stop-word removal, and
-   * word-detection dictionaries. This setting sets a default list of languages used by the
+   * word-detection dictionaries This setting sets a default list of languages used by the
    * `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word
    * detection in the logogram-based
    * [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk)
-   * languages. To support this, you must place the CJK language **first**. **You should always
+   * languages. To support this, you must place the CJK language **first** **You should always
    * specify a query language.** If you don't specify an indexing language, the search engine uses
    * all [supported
    * languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages/),
@@ -352,7 +352,7 @@ public Params addNaturalLanguages(SupportedLanguage naturalLanguagesItem) {
 
   /**
    * ISO language codes that adjust settings that are useful for processing natural language queries
-   * (as opposed to keyword searches): - Sets `removeStopWords` and `ignorePlurals` to the list of
+   * (as opposed to keyword searches) - Sets `removeStopWords` and `ignorePlurals` to the list of
    * provided languages. - Sets `removeWordsIfNoResults` to `allOptional`. - Adds a
    * `natural_language` attribute to `ruleContexts` and `analyticsTags`.
    */
@@ -366,7 +366,7 @@ public Params setEnableRules(Boolean enableRules) {
     return this;
   }
 
-  /** Whether to enable rules. */
+  /** Whether to enable composition rules. */
   @javax.annotation.Nullable
   public Boolean getEnableRules() {
     return enableRules;
@@ -386,7 +386,7 @@ public Params addRuleContexts(String ruleContextsItem) {
   }
 
   /**
-   * Assigns a rule context to the search query. [Rule
+   * Assigns a rule context to the run query [Rule
    * contexts](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/how-to/customize-search-results-by-platform/#whats-a-context)
    * are strings that you can use to trigger matching rules.
    */
@@ -416,7 +416,7 @@ public Params setClickAnalytics(Boolean clickAnalytics) {
   }
 
   /**
-   * Whether to include a `queryID` attribute in the response. The query ID is a unique identifier
+   * Whether to include a `queryID` attribute in the response The query ID is a unique identifier
    * for a search query and is required for tracking [click and conversion
    * events](https://www.algolia.com/guides/sending-events/getting-started/).
    */
@@ -463,7 +463,10 @@ public Params setEnableABTest(Boolean enableABTest) {
     return this;
   }
 
-  /** Whether to enable A/B testing for this search. */
+  /**
+   * Whether to enable index level A/B testing for this run request. If the composition mixes
+   * multiple indices, the A/B test is ignored.
+   */
   @javax.annotation.Nullable
   public Boolean getEnableABTest() {
     return enableABTest;
@@ -476,8 +479,8 @@ public Params setEnableReRanking(Boolean enableReRanking) {
 
   /**
    * Whether this search will use [Dynamic
-   * Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking/). This setting only has
-   * an effect if you activated Dynamic Re-Ranking for this index in the Algolia dashboard.
+   * Re-Ranking](https://www.algolia.com/doc/guides/algolia-ai/re-ranking/) This setting only has an
+   * effect if you activated Dynamic Re-Ranking for this index in the Algolia dashboard.
    */
   @javax.annotation.Nullable
   public Boolean getEnableReRanking() {