field-notes

Explainers

Published
Separator
Author
rhizae
Separator
Last updated

Pieces that take one method, dataset, or document and show a reader how to read it.

An explainer assumes the reader is capable and unfamiliar. It takes one thing — a dataset, a chart convention, a document type — and shows how to read it, including the parts that are easy to misread.

What is here now

What a good statistical brief does in four pages reads a National Center for Health Statistics mortality brief closely and treats it as a format worth copying: each finding stated as a sentence with its number before any chart appears. It is the model for this kind of piece, a real document embedded in full rather than described.

Charts that survive without color is adjacent. It demonstrates chart encodings that do not depend on hue, and explains why a chart that works only in color is an exclusion rather than a style choice.

What makes an explainer work

Naming the specific thing to look for. “Read carefully” is not an explainer. “An age-adjusted death rate and a crude rate answer different questions, so check which one a comparison uses” is, because a reader can carry it to the next document they meet.

What is not an explainer

An argument for a position, which belongs in Articles. A description of how this practice works, which belongs under methods. The test is whether the piece leaves the reader able to read something else.