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

algolia/api-clients-automation#3969

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

Author: algolia-bot

packages/client_recommend/lib/src/model/search_recommend_rules_params.dart

@@ -27,12 +27,12 @@ final class SearchRecommendRulesParams {
   @JsonKey(name: r'context')
   final String? context;
 
-  /// 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.
   // minimum: 0
   @JsonKey(name: r'page')
   final int? page;
 
-  /// 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.
   // minimum: 1
   // maximum: 1000
   @JsonKey(name: r'hitsPerPage')

packages/client_search/lib/src/model/search_dictionary_entries_response.dart

@@ -20,7 +20,7 @@ final class SearchDictionaryEntriesResponse {
   @JsonKey(name: r'hits')
   final List<DictionaryEntry> hits;
 
-  /// 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.
   // minimum: 0
   @JsonKey(name: r'page')
   final int page;

packages/client_search/lib/src/model/search_rules_params.dart

@@ -29,12 +29,12 @@ final class SearchRulesParams {
   @JsonKey(name: r'context')
   final String? context;
 
-  /// 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.
   // minimum: 0
   @JsonKey(name: r'page')
   final int? page;
 
-  /// 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.
   // minimum: 1
   // maximum: 1000
   @JsonKey(name: r'hitsPerPage')

packages/client_search/lib/src/model/search_user_ids_response.dart

@@ -30,7 +30,7 @@ final class SearchUserIdsResponse {
   @JsonKey(name: r'page')
   final int page;
 
-  /// 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.
   // minimum: 1
   // maximum: 1000
   @JsonKey(name: r'hitsPerPage')