| name | eli5 |
|---|---|
| description | Use when explaining a complex technical concept, system, decision, or piece of code in plain English to someone smart but new to the domain — in conversation or in writing. Triggers include "eli5 X", "explain like I'm five", "I don't understand X", "walk me through this", "what does this actually do", "you've lost me", "say it straight", "in plain English", "drop the jargon", or any explanation where the audience shouldn't be assumed to know the jargon. |
Never open with a content-free lead-in. No "The one idea…", "The big idea…", "The one thing…", "Here's the gist…", or any paraphrase that announces an insight is coming instead of stating it. This ban covers the first words out — conversational reply or heading alike — not only section titles. If the explanation has a load-bearing insight, open with the insight itself, named for its content ("Fix commits are our entire universe"); if it doesn't, open with the problem. See "Lead with the load-bearing insight" belo