Three guidelines for tests/examples (terse version)
-
Every word in the example should be about what the example is trying to show.
-
The intended audience is a human being asking first “How do I…?” and then “What happens when…?”
-
Possibilities should be grouped so you can see them all at once.