fix(specs): Add context to hitsPerPage (generated)

algolia/api-clients-automation#3969

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

Author: algolia-bot

algoliasearch/Models/Recommend/SearchRecommendRulesParams.cs

@@ -38,16 +38,16 @@ public SearchRecommendRulesParams()
   public string Context { get; set; }
 
   /// <summary>
-  /// Requested page of the API response.
+  /// Requested page of the API response.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. 
   /// </summary>
-  /// <value>Requested page of the API response.</value>
+  /// <value>Requested page of the API response.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. </value>
   [JsonPropertyName("page")]
   public int? Page { get; set; }
 
   /// <summary>
-  /// Maximum number of hits per page.
+  /// Maximum number of hits per page.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. 
   /// </summary>
-  /// <value>Maximum number of hits per page.</value>
+  /// <value>Maximum number of hits per page.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. </value>
   [JsonPropertyName("hitsPerPage")]
   public int? HitsPerPage { get; set; }
 

algoliasearch/Models/Search/SearchDictionaryEntriesResponse.cs

@@ -25,7 +25,7 @@ public SearchDictionaryEntriesResponse() { }
   /// Initializes a new instance of the SearchDictionaryEntriesResponse class.
   /// </summary>
   /// <param name="hits">Dictionary entries matching the search criteria. (required).</param>
-  /// <param name="page">Requested page of the API response. (required).</param>
+  /// <param name="page">Requested page of the API response.  Algolia uses &#x60;page&#x60; and &#x60;hitsPerPage&#x60; to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - &#x60;hitsPerPage&#x60;: sets the number of search results (_hits_) displayed per page. - &#x60;page&#x60;: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is &#x60;page&#x3D;0&#x60;, the second is &#x60;page&#x3D;1&#x60;, and so on.  For example, to display 10 results per page starting from the third page, set &#x60;hitsPerPage&#x60; to 10 and &#x60;page&#x60; to 2.  (required).</param>
   /// <param name="nbHits">Number of results (hits). (required).</param>
   /// <param name="nbPages">Number of pages of results. (required).</param>
   public SearchDictionaryEntriesResponse(List<DictionaryEntry> hits, int page, int nbHits, int nbPages)
@@ -44,9 +44,9 @@ public SearchDictionaryEntriesResponse(List<DictionaryEntry> hits, int page, int
   public List<DictionaryEntry> Hits { get; set; }
 
   /// <summary>
-  /// Requested page of the API response.
+  /// Requested page of the API response.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. 
   /// </summary>
-  /// <value>Requested page of the API response.</value>
+  /// <value>Requested page of the API response.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. </value>
   [JsonPropertyName("page")]
   public int Page { get; set; }
 

algoliasearch/Models/Search/SearchRulesParams.cs

@@ -44,16 +44,16 @@ public SearchRulesParams()
   public string Context { get; set; }
 
   /// <summary>
-  /// Requested page of the API response.
+  /// Requested page of the API response.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. 
   /// </summary>
-  /// <value>Requested page of the API response.</value>
+  /// <value>Requested page of the API response.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. </value>
   [JsonPropertyName("page")]
   public int? Page { get; set; }
 
   /// <summary>
-  /// Maximum number of hits per page.
+  /// Maximum number of hits per page.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. 
   /// </summary>
-  /// <value>Maximum number of hits per page.</value>
+  /// <value>Maximum number of hits per page.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. </value>
   [JsonPropertyName("hitsPerPage")]
   public int? HitsPerPage { get; set; }
 

algoliasearch/Models/Search/SearchUserIdsResponse.cs

@@ -27,7 +27,7 @@ public SearchUserIdsResponse() { }
   /// <param name="hits">User objects that match the query. (required).</param>
   /// <param name="nbHits">Number of results (hits). (required).</param>
   /// <param name="page">Page of search results to retrieve. (required) (default to 0).</param>
-  /// <param name="hitsPerPage">Maximum number of hits per page. (required) (default to 20).</param>
+  /// <param name="hitsPerPage">Maximum number of hits per page.  Algolia uses &#x60;page&#x60; and &#x60;hitsPerPage&#x60; to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - &#x60;hitsPerPage&#x60;: sets the number of search results (_hits_) displayed per page. - &#x60;page&#x60;: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is &#x60;page&#x3D;0&#x60;, the second is &#x60;page&#x3D;1&#x60;, and so on.  For example, to display 10 results per page starting from the third page, set &#x60;hitsPerPage&#x60; to 10 and &#x60;page&#x60; to 2.  (required) (default to 20).</param>
   /// <param name="updatedAt">Date and time when the object was updated, in RFC 3339 format. (required).</param>
   public SearchUserIdsResponse(List<UserHit> hits, int nbHits, int page, int hitsPerPage, string updatedAt)
   {
@@ -60,9 +60,9 @@ public SearchUserIdsResponse(List<UserHit> hits, int nbHits, int page, int hitsP
   public int Page { get; set; }
 
   /// <summary>
-  /// Maximum number of hits per page.
+  /// Maximum number of hits per page.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. 
   /// </summary>
-  /// <value>Maximum number of hits per page.</value>
+  /// <value>Maximum number of hits per page.  Algolia uses `page` and `hitsPerPage` to control how search results are displayed ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).  - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is `page=0`, the second is `page=1`, and so on.  For example, to display 10 results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2. </value>
   [JsonPropertyName("hitsPerPage")]
   public int HitsPerPage { get; set; }