---
name: explaining-to-beginners
description: Explain something to someone with no background, without condescension and without jargon that quietly requires prior knowledge. Use when writing introductory material or onboarding someone new.
---

# Explaining to beginners

The difficulty is invisible assumptions: words that seem plain but carry
technical meaning, and steps so automatic to you that you omit them
entirely. Beginners then conclude they are the problem.

## Method

1. **Assume no prior vocabulary.** Every technical word is either
   avoided or defined at first use, including the ones that feel like
   ordinary English.
2. **Include the steps you consider obvious.** The omitted step is where
   beginners stop, and it is invisible to you precisely because it is
   automatic.
3. **Use an analogy and then state its limits.** Analogies carry
   understanding a distance and then mislead, so naming where it breaks
   is part of using one.
4. **Show the whole before the parts.** A map of where this fits stops
   the learner assembling detail with no frame (see
   curriculum-sequencing).
5. **Avoid the word simply.** If it were simple they would already know
   it, and the word signals that struggling is a personal failing.
6. **Give a working example they can run.** Something that succeeds
   early builds the confidence to continue (see
   documentation-for-adoption).
7. **Anticipate the predictable confusion.** Address the misreading you
   know is coming before it happens rather than after.

## Boundaries

Beginner explanations trade completeness for accessibility and need a
path to the full picture. Over-simplification that must be unlearned is
worse than a harder correct explanation. Beginners vary widely, so one
explanation cannot fit everyone.