diff --git a/docs/book/src/declare/03_plurals.md b/docs/book/src/declare/03_plurals.md
index 9f5bc010..13c7ea06 100644
--- a/docs/book/src/declare/03_plurals.md
+++ b/docs/book/src/declare/03_plurals.md
@@ -23,7 +23,7 @@ This can be solved by defining 2 plural forms:
 }
 ```
 
-Providing the count to the `t!` macro with the `$`, this will result in:
+Providing the count to the `t!` macro, this will result in:
 
 ```rust
 let i18n = use_i18n();
@@ -33,7 +33,16 @@ t!(i18n, items, count = || 1) // -> "1 item"
 t!(i18n, items, count = || 4) // -> "4 items"
 ```
 
-`{{ count }}` is a special variable when using plurals, you don't supply it as `t!(i18n, key, count = ..)` but with the `$`.
+`{{ count }}` is a special variable when using plurals, even if you don't interpolate it you ust supply it:
+
+```json
+{
+  "items_one": "one item",
+  "items_other": "some items"
+}
+```
+
+This will still need you to supply the `count` variable: `t!(i18n, items, count = ...)`.
 
 ## Why bother ?
 
diff --git a/docs/book/src/usage/04_t_macro.md b/docs/book/src/usage/04_t_macro.md
index 9233a684..16c730ea 100644
--- a/docs/book/src/usage/04_t_macro.md
+++ b/docs/book/src/usage/04_t_macro.md
@@ -153,12 +153,20 @@ Basically `<name .../>` expand to `move |children| view! { <name ...>{children}<
 
 ## Ranges
 
-Ranges expect a variable `$` that implement `Fn() -> N + Clone + 'static` where `N` is the specified type of the range (default is `i32`).
+Ranges expect a variable `count` that implement `Fn() -> N + Clone + 'static` where `N` is the specified type of the range (default is `i32`).
 
 ```rust
 t!(i18n, key_to_range, count = count);
 ```
 
+## Plurals
+
+Plurals expect a variable `count` that implement `Fn() -> N + Clone + 'static` where `N` implement `Into<icu_plurals::PluralsOperands>` ([`PluralsOperands`](https://docs.rs/icu/latest/icu/plurals/struct.PluralOperands.html)). Integers and unsigned primitives implements it, along with `FixedDecimal`.
+
+```rust
+t!(i18n, key_to_plurals, count = count);
+```
+
 ## Access subkeys
 
 You can access subkeys by simply separating the path with `.`:
diff --git a/docs/book/src/usage/05_td_macro.md b/docs/book/src/usage/05_td_macro.md
index e6f11f90..53c24b66 100644
--- a/docs/book/src/usage/05_td_macro.md
+++ b/docs/book/src/usage/05_td_macro.md
@@ -18,14 +18,14 @@ pub fn Foo() -> impl IntoView {
 
     view! {
         <For
-            each = || [Locale::en, Locale::fr]
-            key = |locale| *locale
-            view = move |locale| view! {
-                <button on:click = move|_| i18n.set_locale(locale)>
-                    {td!(locale, set_locale)}
-                </button>
-            }
-        />
+            each = Locale::get_all
+            key = |locale| **locale
+            let:locale
+        >
+            <button on:click = move|_| i18n.set_locale(*locale)>
+                {td!(*locale, set_locale)}
+            </button>
+        </For>
     }
 }
 ```