What good looks like
A finding says what is wrong; an exemplar shows something that already gets it right, so a fix can point at a working example instead of a description. Each one is measured like a finding (where, when, on what device), says why it works, and says honestly what it still does not do. They come from anywhere: our own sites, other sites, browsers, apps.
- EX-001WorksSafari on iPad hides its toolbars the same way every time, after a small scroll
It is predictable. The trigger is a small distance scrolled, which the reader controls, not the speed of the gesture, so it behaves the same every time and is learned after one or two uses. The collapsed state is small enough to be a fair trade for the space, and getting there costs only a couple of lines of scroll, so the reader never loses their place to reach it.
- EX-002WorksDictation that shows your words as you speak them
Seeing your words appear is proof that they are being captured. It is the reason the reporter uses this input over others: as long as the text keeps appearing, they know the recording is safe, and they can keep their attention on what they are saying.
Each exemplar is linked from the findings it answers, and from the principle it demonstrates. The source is /data/exemplars.json.