Quoting Julia Evans

· Source: Simon Willison's Weblog · Field: Technology & Digital — Technical Communication · Depth: Fundamental Awareness, quick

Summary

Julia Evans, in her piece "write for 1 person" published on June 15, 2026, advocates for a highly targeted approach to technical communication. She suggests that instead of attempting to address a broad, undefined audience, authors should envision a single, specific individual and tailor their writing directly to that person. Evans often uses the mental model of "me, but 3 years ago" or a close friend as her intended reader. This method aims to make content more focused, relatable, and effective by addressing the specific knowledge gaps or interests of a singular, well-understood recipient. This strategy helps to clarify the message, ensure its relevance, and overcome the common challenge of writing for an abstract group.

Key takeaway

For technical writers or educators aiming for impactful content, you should adopt a "write for one person" mindset. Instead of generalizing, define your target reader precisely, perhaps as your past self or a colleague. This approach ensures your explanations directly address their specific needs and knowledge level, making your message resonate more deeply. You will produce clearer, more effective documentation or instructional materials.

Key insights

Tailoring communication to one specific person enhances clarity and relevance.

Principles

Method

Envision a specific individual, such as "me, but 3 years ago" or a friend, then write directly for them.

In practice

Topics

Best for: Software Engineer, Research Scientist

Related on AIssential

Open in AIssential →

Editorial summary, takeaway, and curation by AIssential. Original article published by Simon Willison's Weblog.