and now for something completely different

Author: jnumainville

plugins/ui/docs/components/router.md

@@ -107,12 +107,12 @@ app = app()
 
 This produces the following route table:
 
-| URL Path         | Matched Element | Params                   |
-| ---------------- | --------------- | ------------------------ |
-| `/`              | `dashboard`     | `{}`                     |
-| `/users`         | `user_page`     | `{}`                     |
-| `/users/42`      | `user_page`     | `{"user_id": "42"}`      |
-| `/anything-else` | `not_found`     | `{"*": "anything-else"}` |
+| URL Path         | Matched Element | Params                    |
+| ---------------- | --------------- | ------------------------- |
+| `/`              | `dashboard`     | none                      |
+| `/users`         | `user_page`     | none                      |
+| `/users/42`      | `user_page`     | `"user_id"` = `"42"`      |
+| `/anything-else` | `not_found`     | `"*"` = `"anything-else"` |
 
 ## Recommendations
 
@@ -146,11 +146,17 @@ This produces the following route table:
 
 #### Path patterns
 
-- `{var_name}`: Required dynamic segment
-- `{var_name?}`: Optional dynamic segment (matches zero or one segments)
-- `*`: Wildcard, matches any remaining path segments
-- Static text: Exact match
+```python skip-test
+{var_name}   # Required dynamic segment
+{var_name?}  # Optional dynamic segment (matches zero or one segments)
+*            # Wildcard, matches any remaining path segments
+segment      # Static text: Exact match
+```
 
 See [`use_params`](../hooks/use_params.md) for more details on route parameters.
 
-Child paths are appended to parent paths. For example, `ui.route(ui.route(path="{user_id}"), path="users")` produces `/users/{user_id}`.
+Child paths are appended to parent paths. For example:
+
+```python skip-test
+ui.route(ui.route(path="{user_id}"), path="users")  # produces /users/{user_id}
+```

plugins/ui/docs/hooks/use_params.md

@@ -104,11 +104,13 @@ app = app()
 
 ## Route Parameter Patterns
 
-Route parameters are defined by <code>{"{var_name}"}</code> segments in route paths:
+Route parameters are defined by segments in the route path that are enclosed in curly braces. The following patterns are supported:
 
-- `{user_id}` matches a required segment and extracts it as `"user_id"` in the params dict.
-- `{tab?}` matches an optional segment. The parameter is not included if the segment is missing.
-- `*` matches any remaining path. The value is available as the `"*"` key.
+```python skip-test
+{var_name}   # matches a required segment and extracts it as "var_name" in the params dict
+{tab?}       # matches an optional segment; the parameter is omitted if the segment is missing
+*            # matches any remaining path; the value is available as the "*" key
+```
 
 See [`router`](../components/router.md) for more details on defining routes and path patterns.