NOTE 03 / SHORT READ

Keep examples small enough to follow

A good example isolates the idea it is trying to teach. Remove details that require explanations of their own, but leave enough context for the result to make sense.

Explain assumptions explicitly. A reader should know whether an example is a complete procedure, an illustration or a starting point that needs adaptation.