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

algolia/api-clients-automation#3969

Co-authored-by: algolia-bot <accounts+algolia-api-client-bot@algolia.com>

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')