Note 04 · Explanation
Choose an example that answers a real question
An example makes an idea easier to examine. It works best when its details reveal the distinction the reader is trying to understand.
Keep the situation small
Use one ordinary situation with a clear starting condition and result. For a note about file labels, compare two plausible names for the same document. There is no need to invent a whole organisation or a complicated history when the smaller comparison shows the principle.
Explain the relevant difference
After the example, say what changed and why it matters. Do not assume that readers will draw the intended lesson from a colourful story. Leave out details that do not affect the comparison; each extra detail creates another possible interpretation.
Show the limit of the example
One case can explain a mechanism without proving that it describes every case. Keep that boundary visible in the wording. If a second example is needed, choose one that reveals a different limit or use, instead of repeating the same lesson with new names.