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

algoliasearch/composition/models/main_injection_query_parameters.py

@@ -193,7 +193,7 @@ class MainInjectionQueryParameters(BaseModel):
     faceting_after_distinct: Optional[bool] = None
     """ 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`.  """
     facets: Optional[List[str]] = None
-    """ 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).  """
     hits_per_page: Optional[int] = None
     """ Number of hits per page. """
     max_values_per_facet: Optional[int] = None

algoliasearch/composition/models/params.py

@@ -33,8 +33,8 @@
     "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",
@@ -78,9 +78,9 @@ class Params(BaseModel):
     """ Whether the run response should include detailed ranking information. """
     relevancy_strictness: Optional[int] = None
     """ 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.  """
-    facets: Optional[List[str]] = None
-    """ 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).  """
     facet_filters: Optional[FacetFilters] = None
+    facets: Optional[List[str]] = None
+    """ 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).  """
     optional_filters: Optional[OptionalFilters] = None
     numeric_filters: Optional[NumericFilters] = None
     hits_per_page: Optional[int] = None