T48g Docs · Motion passes review

frontend/src/docs/motion.md

@@ -8,7 +8,7 @@ Ely's motion lives in `ely_gpui_component::motion`: four durations, a few easing
 | --- | --- |
 | `FAST`, `BASE`, `SLOW` | 120, 200 and 320 ms. |
 | `THEME` | 280 ms, the theme's cross-fade. |
-| `NUDGE` | 4px, the travel of a small entrance. |
+| `NUDGE` | 4px, the unit a small entrance travels by. |
 | `duration(base, cx)` | `base`, or 1 ms under reduced motion. Pass every duration through it. |
 | `ease_out_cubic`, `ease_in_out_cubic`, `lerp` | Plain functions of `t` from 0 to 1. |
 | `spring` | A damped spring. It overshoots past 1 before it settles. |
@@ -34,7 +34,7 @@ Under it, `duration` returns 1 ms, so a change lands at once. A motion that repe
 | `Flash::new(id, key)` | A tint each time `key` changes, fading out. |
 | `Shake::new(id, key)` | A shake each time `key` changes; still under reduced motion. |
 | `Spinner`, `ProgressBar`, `ProgressRing` | Progress, held still under reduced motion where they repeat. |
-| `Skeleton`, `Shimmer` | Placeholders while content loads. |
+| `Skeleton`, `Shimmer` | A placeholder while content loads, and a band that sweeps over what it holds. |
 | `Flip`, `AnimatePresence`, `Reorder` | Keyed rows that glide to new places, enter, leave, or drag. |
 
 `Flash` and `Shake` read the time since `key` changed; they do not restart an animation, so what they hold keeps its focus and state.