Repository navigation
Commit f606ad4
committed
docs: say what things are, not what they are not
Three sentences defined something by naming a category it does not belong to.
Each one assumed the reader was mid-mistake, and none of them said anything
actionable, since the real advice was always in the sentences around them.
"A fallback is not a loading strategy" was a topic sentence for a paragraph
that already gives the advice. Deleted; the paragraph reads better without it.
"Reach for it when a scroller inside the root clips the target, not when you
want to adjust the viewport" both repeated the sentence before it and
corrected a reader who had not done anything. `scrollMargin` is now described
once, and the section on where to observe is where you find out when to use
it.
"It is not a layout ratio" guarded a genuine trap, since `mockAllIsIntersecting(0.3)`
does look like thirty percent visible. Naming what the number does select,
which of your configured thresholds the observer crossed, closes the same trap
without the correction.
Left the README FAQ line about `root` not being the viewport. That section
answers a reader who has already hit the problem and gone looking, so telling
them what is not true is the answer they came for.1 parent 1254254 commit f606ad4
3 files changed
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | | - | |
| 27 | + | |
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
44 | | - | |
| 44 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
103 | 103 | | |
104 | 104 | | |
105 | 105 | | |
106 | | - | |
| 106 | + | |
107 | 107 | | |
108 | 108 | | |
109 | 109 | | |
| |||
0 commit comments