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/Models/Composition/MainInjectionQueryParameters.cs

@@ -347,9 +347,9 @@ public MainInjectionQueryParameters() { }
   public bool? FacetingAfterDistinct { get; set; }
 
   /// <summary>
-  /// 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).
   /// </summary>
-  /// <value>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). </value>
+  /// <value>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). </value>
   [JsonPropertyName("facets")]
   public List<string> Facets { get; set; }
 

algoliasearch/Models/Composition/Params.cs

@@ -56,19 +56,19 @@ public Params() { }
   [JsonPropertyName("relevancyStrictness")]
   public int? RelevancyStrictness { get; set; }
 
-  /// <summary>
-  /// 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).
-  /// </summary>
-  /// <value>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). </value>
-  [JsonPropertyName("facets")]
-  public List<string> Facets { get; set; }
-
   /// <summary>
   /// Gets or Sets FacetFilters
   /// </summary>
   [JsonPropertyName("facetFilters")]
   public FacetFilters FacetFilters { get; set; }
 
+  /// <summary>
+  /// 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).
+  /// </summary>
+  /// <value>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). </value>
+  [JsonPropertyName("facets")]
+  public List<string> Facets { get; set; }
+
   /// <summary>
   /// Gets or Sets OptionalFilters
   /// </summary>
@@ -224,8 +224,8 @@ public override string ToString()
     sb.Append("  Page: ").Append(Page).Append("\n");
     sb.Append("  GetRankingInfo: ").Append(GetRankingInfo).Append("\n");
     sb.Append("  RelevancyStrictness: ").Append(RelevancyStrictness).Append("\n");
-    sb.Append("  Facets: ").Append(Facets).Append("\n");
     sb.Append("  FacetFilters: ").Append(FacetFilters).Append("\n");
+    sb.Append("  Facets: ").Append(Facets).Append("\n");
     sb.Append("  OptionalFilters: ").Append(OptionalFilters).Append("\n");
     sb.Append("  NumericFilters: ").Append(NumericFilters).Append("\n");
     sb.Append("  HitsPerPage: ").Append(HitsPerPage).Append("\n");
@@ -280,14 +280,14 @@ public override bool Equals(object obj)
         RelevancyStrictness == input.RelevancyStrictness
         || RelevancyStrictness.Equals(input.RelevancyStrictness)
       )
-      && (
-        Facets == input.Facets
-        || Facets != null && input.Facets != null && Facets.SequenceEqual(input.Facets)
-      )
       && (
         FacetFilters == input.FacetFilters
         || (FacetFilters != null && FacetFilters.Equals(input.FacetFilters))
       )
+      && (
+        Facets == input.Facets
+        || Facets != null && input.Facets != null && Facets.SequenceEqual(input.Facets)
+      )
       && (
         OptionalFilters == input.OptionalFilters
         || (OptionalFilters != null && OptionalFilters.Equals(input.OptionalFilters))
@@ -385,14 +385,14 @@ public override int GetHashCode()
       hashCode = (hashCode * 59) + Page.GetHashCode();
       hashCode = (hashCode * 59) + GetRankingInfo.GetHashCode();
       hashCode = (hashCode * 59) + RelevancyStrictness.GetHashCode();
-      if (Facets != null)
-      {
-        hashCode = (hashCode * 59) + Facets.GetHashCode();
-      }
       if (FacetFilters != null)
       {
         hashCode = (hashCode * 59) + FacetFilters.GetHashCode();
       }
+      if (Facets != null)
+      {
+        hashCode = (hashCode * 59) + Facets.GetHashCode();
+      }
       if (OptionalFilters != null)
       {
         hashCode = (hashCode * 59) + OptionalFilters.GetHashCode();