small description change for items selector UI

CHANGELOG.md

@@ -251,7 +251,7 @@
 
 - Improvements for compact extra
 - Refactoring of test structure and tasks
-- Added items extra: Allow the client to request a custom number of items per page with a ready to use selector UI
+- Added items extra: Allow the client to request a custom number of items per page with an optional selector UI
 
 ### Commits
 

README.md

@@ -42,7 +42,7 @@ _The [IPS/Kb ratio](http://ddnexus.github.io/pagination-comparison/gems.html#eff
 
 - The `Pagy` class doesn't need to know anything about your models, ORM or storage, so it doesn't add any code to them _(see [why...](https://ddnexus.github.io/pagy/index#stay-away-from-the-models))_
 - It works with all kinds of collections, even pre-paginated, records, Arrays, JSON data... and just whatever you can count _(see [how...](https://ddnexus.github.io/pagy/how-to#paginate-any-collection))_
-- Pagy works with all Rack frameworks (Rails, Sinatra, Padrino, ecc.) out of the box _(see [more...](https://ddnexus.github.io/pagy/how-to#environment-assumptions))_
+- Pagy works with the most popular Rack frameworks (Rails, Sinatra, Padrino, ecc.) out of the box _(see [more...](https://ddnexus.github.io/pagy/how-to#environment-assumptions))_
 - It works also with any possible non-Rack environment by just overriding one or two two-lines methods _(see [more...](https://ddnexus.github.io/pagy/how-to#environment-assumptions))_
 
 ### Unlike the other gems
@@ -98,7 +98,7 @@ Use the official extras, or write your own in just a few lines. Extras add speci
 ### Feature Extras
 
 - [i18n](http://ddnexus.github.io/pagy/extras/i18n): Use the `I18n` gem instead of the pagy implementation
-- [items](http://ddnexus.github.io/pagy/extras/items): Allow the client to request a custom number of items per page with a ready to use selector UI
+- [items](http://ddnexus.github.io/pagy/extras/items): Allow the client to request a custom number of items per page with an optional selector UI
 - [out_of_range](http://ddnexus.github.io/pagy/extras/out_of_range): Allow for easy handling of out of range pages
 - [trim](http://ddnexus.github.io/pagy/extras/trim): Remove the `page=1` param from the first page link
 

docs/extras/items.md

@@ -3,7 +3,7 @@ title: Items
 ---
 # Items Extra
 
-Allow the client to request a custom number of items per page with a ready to use selector UI. It is useful with APIs or higly user-customizable apps.
+Allow the client to request a custom number of items per page with an optional selector UI. It is useful with APIs or higly user-customizable apps.
 
 ## Synopsys
 
@@ -54,7 +54,7 @@ Pagy.new(count:100, items_param: :custom_param, max_items: 50)
 **Notice**: you can override the items that the client sends with the params by passing the `:items` explicitly. For example:
 
 ```ruby
-# this will ignore the params[:item] (or any custom :param_name)
+# this will ignore the params[:items] (or any custom :param_name)
 # from the client for this instance, and serve 30 items
 pagy(scope, items: 30)
 ```

lib/config/pagy.rb

@@ -52,7 +52,7 @@
 
 # Feature Extras
 
-# Items: Allow the client to request a custom number of items per page with a ready to use selector UI
+# Items: Allow the client to request a custom number of items per page with an optional selector UI
 # See https://ddnexus.github.io/pagy/extras/items
 # require 'pagy/extras/items'
 # Pagy::VARS[:items_param] = :items    # default