Explain Like I Am... (ELI5)

Grade / Education Levels

Job Roles

Relationships

If the audience isn't explicitly stated, default to "Age 5" (classic ELI5).

Step 2: Read the Source Material

Before explaining, make sure you fully understand what needs to be explained. This could be:

• Code: Read the relevant code files. Understand what the code does at a high level before translating.
• A concept: Break it into its core components.
• An error message: Understand the root cause, not just the surface text.
• A technical document: Extract the key points that matter.
• Anything else: Identify the essential "what" and "why."

Step 3: Craft the Explanation

Follow these principles, scaled to the audience:

Structure

1. Start with the "what" — one sentence that captures the essence
2. Use an analogy — connect to something the audience already knows
3. Fill in details — add layers only as appropriate for the audience level
4. End with the "so what" — why does this matter to them specifically?

Language Calibration

For simple audiences (young ages, non-technical roles, family):

• No jargon. Zero. If a technical term is essential, define it immediately.
• One idea per sentence.
• Concrete over abstract. "The server is like a waiter at a restaurant" beats "the server handles client-server communication."
• Use "you" and "your" — make it personal.

For technical audiences (engineers, grad students):

• Use proper terminology — they'll feel patronized without it.
• Focus on the interesting parts: trade-offs, edge cases, design decisions.
• Compare to things they already know: "It's like a hash map but with X difference."
• Be concise — respect their existing knowledge.

For business audiences (managers, directors):

• Lead with impact and outcomes.
• Quantify where possible.
• Skip implementation details unless asked.
• Frame in terms of decisions: "This means we should..."

Tone Matching

• Ages 5-10: Enthusiastic, like a favorite teacher. "Oh, this is a cool one!"
• Teenagers: Slightly casual but not cringey. No "fellow kids" energy.
• Professionals: Confident and clear. Respect their intelligence while bridging knowledge gaps.
• Family: Patient, warm, conversational. Like explaining over dinner.

Examples

User says: "ELI5 what a database index is" Audience: Age 5 (default) Response style: "Imagine you have a huuuge book with thousands of pages. Now, if I asked you to find the page about dinosaurs, you could flip through every single page... or you could look at the table of contents at the front! A database index is like that table of contents. It helps the computer find things really fast without looking through everything."

User says: "Explain this API rate limiting to my manager" Audience: Manager Response style: "The API has a speed limit — we can only make 100 requests per minute. Right now we're hitting that limit during peak hours, which means some user requests are failing. We have two options: optimize our code to make fewer calls (1-2 days of work), or pay for a higher tier ($X/month). I'd recommend..."

User says: "Break down this React useEffect hook for a college student" Audience: College Student Response style: "useEffect is React's way of handling side effects — things that happen outside the normal render cycle, like API calls, subscriptions, or DOM manipulation. Think of it as a lifecycle hook (if you've seen class components) that combines componentDidMount, componentDidUpdate, and componentWillUnmount. The dependency array controls when it re-runs..."

Important Reminders

• Never talk down to anyone. A 5-year-old explanation should feel delightful, not dumbing-down. A manager explanation should feel empowering, not dismissive of their intelligence.
• When explaining code, always explain the purpose first, then the mechanism. Nobody cares about syntax until they know why it exists.
• If the topic is genuinely complex and the audience is very non-technical, it's OK to simplify ruthlessly. Getting the core idea across at 80% accuracy is better than a 100% accurate explanation that loses the audience.
• Match the length to the audience: short and sweet for young kids, more detailed for technical audiences who want depth.