feat(specs): add specific documentation for facets query parameter in Composition API (generated)

algolia/api-clients-automation#5477

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Clara Muller <[email protected]>

Author: algolia-bot

lib/algolia/models/composition/main_injection_query_parameters.rb

@@ -141,7 +141,7 @@ class MainInjectionQueryParameters
       # Whether faceting should be applied after deduplication with `distinct` This leads to accurate facet counts when using faceting in combination with `distinct`. It's usually better to use `afterDistinct` modifiers in the `attributesForFaceting` setting, as `facetingAfterDistinct` only computes correct facet counts if all records have the same facet values for the `attributeForDistinct`.
       attr_accessor :faceting_after_distinct
 
-      # Facets for which to retrieve facet values that match the search criteria and the number of matching facet values To retrieve all facets, use the wildcard character `*`. For more information, see [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts).
+      # Facets for which to retrieve facet values that match the search criteria and the number of matching facet values To retrieve all facets, use the wildcard character `*`. To retrieve disjunctive facets lists, annotate any facets with the `disjunctive` modifier. For more information, see [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts) and [disjunctive faceting for Smart Groups](https://www.algolia.com/doc/guides/managing-results/compositions/search-based-groups#facets-including-disjunctive-faceting).
       attr_accessor :facets
 
       # Number of hits per page.

lib/algolia/models/composition/params.rb

@@ -23,11 +23,11 @@ class Params
       # Relevancy threshold below which less relevant results aren't included in the results You can only set `relevancyStrictness` on [virtual replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas/#what-are-virtual-replicas). Use this setting to strike a balance between the relevance and number of returned results.
       attr_accessor :relevancy_strictness
 
-      # Facets for which to retrieve facet values that match the search criteria and the number of matching facet values To retrieve all facets, use the wildcard character `*`. For more information, see [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts).
-      attr_accessor :facets
-
       attr_accessor :facet_filters
 
+      # Facets for which to retrieve facet values that match the search criteria and the number of matching facet values To retrieve all facets, use the wildcard character `*`. To retrieve disjunctive facets lists, annotate any facets with the `disjunctive` modifier. For more information, see [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts) and [disjunctive faceting for Smart Groups](https://www.algolia.com/doc/guides/managing-results/compositions/search-based-groups#facets-including-disjunctive-faceting).
+      attr_accessor :facets
+
       attr_accessor :optional_filters
 
       attr_accessor :numeric_filters
@@ -94,8 +94,8 @@ def self.attribute_map
           :page => :page,
           :get_ranking_info => :getRankingInfo,
           :relevancy_strictness => :relevancyStrictness,
-          :facets => :facets,
           :facet_filters => :facetFilters,
+          :facets => :facets,
           :optional_filters => :optionalFilters,
           :numeric_filters => :numericFilters,
           :hits_per_page => :hitsPerPage,
@@ -128,8 +128,8 @@ def self.types_mapping
           :page => :"Integer",
           :get_ranking_info => :"Boolean",
           :relevancy_strictness => :"Integer",
-          :facets => :"Array<String>",
           :facet_filters => :"FacetFilters",
+          :facets => :"Array<String>",
           :optional_filters => :"OptionalFilters",
           :numeric_filters => :"NumericFilters",
           :hits_per_page => :"Integer",
@@ -203,16 +203,16 @@ def initialize(attributes = {})
           self.relevancy_strictness = attributes[:relevancy_strictness]
         end
 
+        if attributes.key?(:facet_filters)
+          self.facet_filters = attributes[:facet_filters]
+        end
+
         if attributes.key?(:facets)
           if (value = attributes[:facets]).is_a?(Array)
             self.facets = value
           end
         end
 
-        if attributes.key?(:facet_filters)
-          self.facet_filters = attributes[:facet_filters]
-        end
-
         if attributes.key?(:optional_filters)
           self.optional_filters = attributes[:optional_filters]
         end
@@ -320,8 +320,8 @@ def ==(other)
           page == other.page &&
           get_ranking_info == other.get_ranking_info &&
           relevancy_strictness == other.relevancy_strictness &&
-          facets == other.facets &&
           facet_filters == other.facet_filters &&
+          facets == other.facets &&
           optional_filters == other.optional_filters &&
           numeric_filters == other.numeric_filters &&
           hits_per_page == other.hits_per_page &&
@@ -360,8 +360,8 @@ def hash
           page,
           get_ranking_info,
           relevancy_strictness,
-          facets,
           facet_filters,
+          facets,
           optional_filters,
           numeric_filters,
           hits_per_page,