The Worked Example Nobody Wants to Redo

A fully worked example is citable for a blunt reason: the alternative is doing the work yourself. When somebody has to explain a calculation, a process or a judgement call — to a client, a colleague, a forum, their own team — they would much rather hand off a page that already walked through it end to end than reconstruct it in a message. That hand-off is the link.

What “worked” actually means

Most pages that claim to work through an example describe it instead. They name the formula, state the answer, and skip the middle. That’s a summary, and summaries don’t get cited, because the reader still has to do the thing.

A worked example has all of this:

Every step shown, including the boring ones. The step you consider too obvious to write down is frequently the step the reader gets wrong. Unit conversions, what to do with the leftover, which figure carries into the next line.
Assumptions stated before the work, not buried in it. If the method only holds when the inputs are independent, or when a month is treated as thirty days, say so at the top. Assumptions discovered halfway down feel like a bait-and-switch, and a reader who feels tricked doesn’t cite you.
The arithmetic visible. Not “we then adjust for seasonality” — the actual adjustment, applied, with both sides of it on the page.
The result interpreted. A number with no sentence explaining what it means is half an answer. Say what a reader should conclude, and what they should not.
At least one edge case where the naive approach gives the wrong answer. This is usually the part that earns the link, because it’s the part nobody else bothered with. Anyone can reproduce the happy path. The page that says “and here’s where this method quietly breaks” is the one people forward.

Choosing the example

Pick the calculation your field does constantly and explains badly. There is always one. It’s the thing people learn by watching a senior colleague do it once, then repeat with slightly wrong reasoning for years. Look for the question that gets asked in your industry’s forums every few weeks and answered with a formula and no worked case.

Two signals you’ve picked well: practitioners disagree about part of it, and the disagreement is resolvable with a clear demonstration rather than an opinion. That combination is the whole basis of claims people quote — you are settling something.

The honesty rules that apply specifically here

Worked examples have their own failure mode, and it’s serious. An illustrative example must be labelled illustrative.

If you invent the inputs, that’s completely fine — most teaching examples have to, because real inputs are confidential or messy. But say plainly that they’re invented. The method is your claim; the numbers are scaffolding for it. A sentence like “suppose a small commercial bakery is deciding whether to add a second delivery run — the figures below are made up to keep the arithmetic legible” costs you nothing and inoculates the whole page.

What you must never do is let a worked example’s made-up figures escape into prose as though they were measurements. It happens by accident: you write the example, then later summarise it in an introduction, and the hedge falls off. Now your page states a figure about the world that you invented for a demonstration. Someone quotes it. Someone else quotes them. That is precisely how unverifiable numbers become common knowledge, and it is the entire difference between a teaching aid and a fabricated statistic. The test is simple: could a reader who skims your page walk away believing a number describes reality when it doesn’t?

When the inputs are real — your own data, your own measurements — the example gets much stronger, and it then needs the other discipline: say how you got them.

Structure

Use the same order every time, because readers arriving mid-page need to orient:

The question, in one sentence, phrased the way somebody would ask it.
The inputs, listed, with units, and flagged as real or hypothetical.
The method, applied step by step, with the reasoning for each step beside it rather than in a footnote.
The result, with its interpretation.
The caveats and variations — what changes if an input doubles, what to do when a value is missing, where the method stops applying.

Then make the working liftable. A plain table or a fenced block someone can select and paste is worth more than a beautifully typeset image, because the person citing you often wants to reproduce the calculation with their own inputs. If the only way to reuse your work is to retype it from a picture, most people will rebuild it from scratch — and then there’s nothing to link to.

Where worked examples go wrong

Too clean to be real. Every number divides evenly, nothing is missing, no judgement is required. Practitioners recognise this instantly and discount the whole page, because their version of the task is never that tidy. Include one awkward input on purpose.

Quietly assuming the reader’s situation matches yours. Scale, jurisdiction, currency, industry conventions. If the method changes for a reader in a different setting and you don’t say so, you’ve published something that’s wrong for most of your audience and confidently right for you.

Stopping before the interesting part. Plenty of examples end at the first result, which is the point where the reader’s actual difficulty begins. The last third — the caveats, the second-order effects, the case where the answer is “don’t do this” — is the part with no competition.

Padding the setup. A worked example doesn’t need six paragraphs of context. Get to the inputs.

What to do next

Pick one calculation your field does constantly, work it end to end on its own page, label your inputs honestly, and put the edge case in rather than leaving it out.

If the numbers are yours, pair it with a published method — a worked example plus a stated methodology is what turns data you already have into something other people can build on. And if the process is easier to see than to read, consider whether the same explanation should also exist as a diagram nobody else has drawn.