diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4505a9f93..e96eba638 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,13 +4,13 @@
 
 ### Breaking Changes
 
-- The `pagy_nav_bootstrap_compact` and `pagy_nav_boostrap_responsive` helpers have been renamed as `pagy_nav_compact_bootstrap` and `pagy_nav_responsive_bootstrap` to keep the consistency with the extras structure (and support the consistency of future framework additions). Please, rename them accordingy.
+- The `pagy_nav_bootstrap_compact` and `pagy_nav_boostrap_responsive` helpers have been renamed as `pagy_nav_compact_bootstrap` and `pagy_nav_responsive_bootstrap` to keep the consistency with the extras structure (and support the consistency of future framework additions). Please, rename them accordingly.
 - The `Pagy::Frontend::I18N.load_file` has been renamed as `Pagy::Frontend::I18N.load` and expects a hash as the argument. See the [I18n doc](https://ddnexus.github.io/pagy/api/frontend#i18n).
 - The seldom used `Pagy::Frontend::I18N[plurals]` has been renamed as `Pagy::Frontend::I18N[plural]`. See the [I18n doc](https://ddnexus.github.io/pagy/api/frontend#i18n).
 
 ### Commits
 
-- [826798b](https://github.com/ddnexus/pagy/commit/826798b): refactoring of I18N constant: added supportv for multiple static languages and plural rules
+- [826798b](https://github.com/ddnexus/pagy/commit/826798b): refactoring of I18N constant: added support for multiple static languages and plural rules
 - [b78b71e](https://github.com/ddnexus/pagy/commit/b78b71e): better naming of json classes
 - [ea7c22b](https://github.com/ddnexus/pagy/commit/ea7c22b): breaking change for compact and responsive extras: renaming of pagy_nav_bootstrap_* helpers to pagy_nav_*_bootstrap, consistent with extras structure
 - [7d1a573](https://github.com/ddnexus/pagy/commit/7d1a573): internal consistency renaming of local/test variables; minor fixes and improvements
diff --git a/docs/assets/css/style.scss b/docs/assets/css/style.scss
index 1cf641954..1229ab207 100644
--- a/docs/assets/css/style.scss
+++ b/docs/assets/css/style.scss
@@ -15,7 +15,7 @@ a:hover, a:focus {
 
 code {
   font-size: .8rem;
-  padding: 2px 5px;
+  padding: 4px 5px 2px;
   background-color: #FFF;
   border-radius: 3px;
   border: 1px solid #e5e5e5;
diff --git a/docs/how-to.md b/docs/how-to.md
index 4f3305c1d..3af8422df 100644
--- a/docs/how-to.md
+++ b/docs/how-to.md
@@ -99,6 +99,8 @@ You can also pass it as an instance variable to the `Pagy.new` method or to the
 @pagy, @records = pagy(Product.some_scope, items: 30)
 ```
 
+If you want to allow the client to request a custom number of items per page - useful with APIs or higly user-customizable apps - take a look at the [items extra](extras/items.md). It manages the number of items per page requested with the params, and offers a ready to use selector UI.
+
 ## Controlling the page links
 
 You can control the number and position of the page links in the navigation through the `:size` variable. It is an array of 4 integers that specify which and how many page links to show.