Sample library explainer: the shape every reference page follows
A worked example of the article scaffold, using all eight sections so the contents list, the layout and the contract check all have something real to run against.
This is a sample article. It exists so the template builds green before a single real word is written, and so every scaffold component is exercised by something. Delete it once the site has real content.
- The 60-second answer goes first, because most readers will not scroll.
- It leads with one plain sentence, then the points that carry it.
- Nothing below this box is required reading to get the answer.
The mechanism, once the answer is out of the way
The second section explains why, for the reader who wants it. It never repeats the answer above; it earns its place by adding the reason. If you cannot write a reason that adds something, cut the section rather than padding it.
Each Layer takes its own id, eyebrow and heading, so a niche can add sections beyond the eight named ones. Only the named eight appear in the contents list, because those are the ones every article shares.
What changes the answer
Most useful answers are conditional. This section names what moves them, so the reader can work out which case they are in rather than assuming the general answer is theirs.
Two concrete cases
Examples are illustrative and invented. Never present a fabricated case as a real one.
What usually happens, described concretely enough to recognise.
The one that does not follow the rule, and what to do instead.
What to watch for
Questions worth asking, and who to ask
When it needs a doctor
The stop-reading-and-act block. Only include it where something genuinely warrants it. On a site with no urgent concept, remove this section and set SITE.urgentCta to null.
A real account belongs here, in someone’s own words, adding what an explanation cannot. Never invent one.