Blog
Example explainer: what is it, and is it worth doing?
Author
chunyu jiang
Published
The lead says why readers ask this question and which angles this article answers it from.
What it is
Define it in two or three sentences. The first sentence is a conclusion that can be quoted on its own; background comes after.
Who should care
Explain which readers run into it and in which situations.
Common questions
How is it different from similar concepts?
State the single most important difference first, then add one example.
What can I expect once it is done?
Describe only effects that can be verified; mark anything unconfirmed with TBD-.
When can I skip it?
Give one condition readers can check against their own situation.