> "Don't write merely to be understood. Write so that you cannot possibly be misunderstood."
Prerequisites
- 1
- none
Learning Objectives
- Identify the four audience variables (knowledge, role/goals, required action, reading context) for any document before drafting it.
- Write the same technical finding four different ways for an expert, a manager, a client, and the general public.
- Explain how the curse of knowledge causes experts to overestimate what readers understand, and apply at least three tactics to counter it.
- Distinguish the four writing purposes (inform, persuade, instruct, record) and choose the right one for a given audience and goal.
- Produce a written audience profile that drives concrete drafting decisions, not vague intentions.
In This Chapter
- Chapter Overview
- 2.1 The Question You Must Answer Before You Write a Word
- 2.2 The Audience-Analysis Framework: Four Questions, Every Time
- 2.3 One Finding, Four Documents: Meet Dana Whitfield
- 2.4 The Same Move, A Software Example
- 2.5 The Curse of Knowledge: Why Experts Write Badly for Non-Experts
- 2.6 Audience and Purpose Are Linked: The Four Things Writing Does
- 2.7 The Challenger Memos: A Failure of Audience Adaptation
- 📐 Project Checkpoint: Write an Audience Profile for Your Portfolio Topic
- 2.8 Common Mistakes & Practical Considerations
- Frequently Asked Questions
- Chapter Summary
- Spaced Review
- What's Next
Chapter 2: Audience: The Most Important Word in Writing (and the One Most Writers Ignore)
"Don't write merely to be understood. Write so that you cannot possibly be misunderstood." — attributed to Robert Louis Stevenson
Chapter Overview
On the evening of January 27, 1986, a group of engineers tried to stop a rocket launch. They had the data. They were right. And they failed to convince the people in the room. The next morning, the Space Shuttle Challenger broke apart seventy-three seconds after liftoff, and seven people died. The engineers' warning was technically correct. It was also, as a piece of communication aimed at the people who had to decide, a failure. We will come back to that night, because it is the clearest lesson this book can offer about the cost of writing for the wrong audience.
You do not need a launch decision to feel this. You have felt it in smaller ways: the email nobody acted on, the report the manager "skimmed," the explanation that left a smart person more confused than before. In Chapter 1, you saw that writing is thinking — that clear sentences are how you discover what you actually know, not just how you package it after the fact. This chapter adds the second half of that truth. Thinking clearly is necessary but not sufficient. You can understand a problem perfectly and still produce a document that helps no one, because you wrote it for yourself instead of for the person who has to read it. There is no such thing as "good writing" in the abstract. There is only writing that is good for a particular reader, doing a particular thing, with a particular amount of time.
This is the most important idea in the book, and it is the one most writers ignore. Not because they are lazy, but because of a cognitive trap so reliable that researchers gave it a name. Once you understand something, you cannot easily remember what it was like not to understand it. You write from inside your own head, forgetting that the reader is standing outside it. By the end of this chapter you will be able to analyze any audience with a four-part framework, take a single technical finding and write it four genuinely different ways, and recognize the trap before it ruins your draft. We will meet Dana Whitfield, a data scientist who has to explain the same result to her VP of Marketing and to her fellow analysts — two readers, two documents, one finding. Get audience right and everything downstream gets easier. Get it wrong and no amount of polish will save you.
In this chapter, you will learn to:
- Analyze any audience using four variables: what they know, what they want, what they must do, and how they will read.
- Translate one technical finding into four distinct documents (expert, manager, client, public) and judge which choices each reader requires.
- Diagnose and defeat the curse of knowledge with named, repeatable tactics.
- Match your purpose (inform, persuade, instruct, record) to your audience instead of defaulting to one mode.
- Write an audience profile that produces concrete drafting decisions.
📕📗📘 All three tracks: this chapter is foundational for everyone — engineers, software developers, and business writers alike. Nobody skips it. If you are on the 📗 Software/CS track, pay special attention to §2.4's worked example, where "the same finding" becomes an internal post-mortem versus a customer-facing status page. If you are on the 📘 Business track, §2.3 (writing for a decision-maker) is the heart of your job. Engineers on the 📕 track: the Challenger case in §2.6 is the one you will see again in Chapters 4, 9, and 38.
2.1 The Question You Must Answer Before You Write a Word
Here is a sentence. Decide, quickly, whether it is good or bad writing:
"Churn increased 4.2 points QoQ, concentrated in the 0–90-day cohort; the random forest flags onboarding friction as the dominant feature."
You can't decide. Not honestly. The sentence is excellent writing if the reader is another data scientist who needs to know exactly what was measured and how. It is terrible writing if the reader is a VP of Marketing who has ninety seconds before her next meeting and does not know what a cohort is. Same words, opposite verdicts. The quality of the sentence is not a property of the sentence. It is a property of the match between the sentence and the reader.
This is why "is this good writing?" is the wrong question. The right question is always "good for whom, doing what?" A medication label, a legal contract, a children's book, and a research abstract are all trying to be clear — but clear to different people for different uses, and so they look nothing alike. The contract is dense because its reader is a lawyer who needs every contingency nailed down and has time to read slowly. The children's book is simple because its reader is six. Neither would survive being swapped.
Most weak technical writing is not weak because the writer can't write. It is weak because the writer never decided who the reader was. They wrote into a vacuum, and a vacuum has no needs, so the writer defaulted to the only needs available — their own. They included what they found interesting. They organized it the way they discovered it. They used the words they use with colleagues. The result feels fine to the writer and lands like a brick on everyone else.
So before you write a word — before the outline, before the first sentence — you answer one question in four parts. Who is reading this? What do they already know? What do they need from it? And how will they actually use it? Skip this and you are guessing. Do it and every later decision (what to include, what to cut, what to define, where to put the conclusion) has a correct answer, because the reader supplies it.
✏️ Try This: Think of the last document you wrote that did not get the response you wanted — an email, a report, a message. In one sentence, name the reader and what you wanted them to do. If you can't, you just found the problem.
Naming the trap up front: writing is a transfer, not a broadcast
Picture the difference between a radio broadcast and handing someone a glass of water. A broadcast goes out in all directions; the sender never checks whether it lands. Handing over water is a transfer: you have to know how thirsty the person is, whether they can hold the glass, whether they'd rather have coffee. Writing is a transfer. The whole point is that something gets from your head into theirs. A transfer that ignores the receiver isn't a transfer at all — it's a broadcast you mistook for one. The four-part question turns the broadcast back into a transfer.
2.2 The Audience-Analysis Framework: Four Questions, Every Time
You can analyze any audience with four variables. They are not abstract. Each one forces a concrete decision about your draft, and together they decide most of the document before you write it. Memorize them as K-R-A-C: Knowledge, Role, Action, Context.
Variable 1 — Knowledge level: what do they already know?
This is the variable everyone gets wrong, and it runs in both directions. Assume too little and you condescend, padding the document with explanations an expert finds insulting and slow. Assume too much and you lose them — every undefined term is a small door slammed in the reader's face, and after three slammed doors they stop reading.
Knowledge is not one dial. It has at least three: domain knowledge (do they understand the subject?), jargon fluency (do they speak the technical vocabulary?), and context knowledge (do they know the background of this specific project?). A new engineer on your team might have high domain knowledge and high jargon fluency but zero context — they don't know why the system was built this strange way three years ago. A veteran VP might have deep context and zero jargon. You calibrate each dial separately.
The practical move: list the three or four terms or concepts your document depends on, and for each, ask does this reader already have it? If yes, use it freely. If no, you must either define it or design around it. There is no third option where you use it undefined and hope.
Variable 2 — Role and goals: who are they, and what do they want?
A reader is not a generic brain. They occupy a role, and the role comes with goals. A manager reading your analysis wants to make a decision and look competent doing it. A fellow engineer wants to verify your reasoning and reuse your method. A client wants reassurance that they spent their money well. A regulator wants to confirm you followed the rules. The same finding serves all four, but each reader is mining it for a different thing.
Ask: why is this person reading my document at all? What job are they trying to get done with it? Nobody reads a technical report for pleasure. They read it to decide, to act, to learn, to check, or to cover themselves. When you know the job, you know what to put first.
Variable 3 — Action: what must they do after reading?
This is the variable that turns vague writing sharp. Every document exists to produce an outcome in the reader. Sometimes the action is a literal decision ("approve the budget"). Sometimes it is a mental action ("understand why the build is slow"). Sometimes it is future-facing ("be able to find this configuration value six months from now"). But there is always a desired next state, and if you can't name it, you are not ready to write.
The test is brutal and useful: finish this sentence — "After reading this, the reader will ____." If the blank is "know a lot about my project," you have failed, because that is not an action; it is a vibe. "After reading this, the VP will approve the retention budget." "After reading this, the on-call engineer will know to restart the cache service first." Those are actionable, and they tell you what the document must contain and what it can leave out.
Variable 4 — Context: how will they actually read it?
People read different documents in completely different ways, and the way they read should shape how you write. Consider the dimensions:
- Skim vs. study. Will they scan for the one number they need, or sit down and work through every line? An executive skims; a peer reviewer studies. Skimmers need headings, bolded conclusions, and a summary up top. Studiers can handle dense, sequential prose.
- Screen vs. print vs. mobile. A document read on a phone in a hallway cannot have a wide table. A document printed and annotated in a meeting needs page numbers and margins. The medium constrains the form.
- Friendly vs. neutral vs. hostile. Is the reader rooting for you, indifferent, or looking for a reason to say no? A grant reviewer with fifty proposals is not hostile but is exhausted and skeptical — write for the tired skeptic. An opposing counsel is hostile and will weaponize any overstatement — write for the adversary who is reading to attack.
- Now vs. later. Will they read it once today, or pull it up as a reference for years? A one-time email and a permanent runbook have opposite needs: the email optimizes for immediate clarity, the runbook for findability and durability.
🔄 Check Your Understanding A senior engineer asks you to write a short doc explaining a tricky configuration setting "so the next person doesn't break it." Run K-R-A-C: name the likely knowledge level, role/goal, required action, and reading context.
Answer
Knowledge: high domain and jargon fluency (they're an engineer), but low context — "the next person" doesn't know the history. Role/goal: a future maintainer trying to safely change or troubleshoot the setting. Action: after reading, they will know what the setting does, what breaks if it's wrong, and the safe way to change it. Context: read later, as a reference, probably while something is already on fire — so optimize for findability (clear heading), durability (it must still make sense in a year), and a scannable "if you change this, do X" warning. This is the opposite of a one-time email.
The framework as a worksheet
Here is the whole thing as a fill-in-the-blank you can run in two minutes before any document:
AUDIENCE PROFILE
1. KNOWLEDGE — Domain: ___ Jargon: ___ Context: ___
— Terms I must define or avoid: ___, ___, ___
2. ROLE/GOAL — Who they are: ___
— Why they're reading: ___
3. ACTION — "After reading, they will ____."
4. CONTEXT — Skim / study? Screen / print / mobile?
— Friendly / neutral / hostile? Now / later?
Two minutes. It feels like a delay. It saves an hour of rewriting and, more often than you'd think, saves the document from doing nothing at all.
[📍 Good stopping point — you now have the framework. The rest of the chapter shows it in action.]
2.3 One Finding, Four Documents: Meet Dana Whitfield
Frameworks are abstract. Let's make this concrete with a single technical result and watch it become four completely different documents.
The scenario (a composite, fictional-but-realistic example). Dana Whitfield is a data scientist at a subscription software company. She has spent two weeks analyzing why customers cancel. Her finding, stated precisely for herself, is this:
Quarterly churn rose from 5.1% to 9.3% over two quarters. The increase is concentrated almost entirely in accounts younger than 90 days. A random-forest model identifies time-to-first-value — the number of days before a new customer completes a meaningful action in the product — as the dominant predictor. Accounts that reach first value within 7 days churn at 3%; accounts that take longer than 21 days churn at 22%. The data suggests the onboarding flow, not the product or the price, is the leak.
That is the finding. It is correct, it is precise, and — depending on who reads it — it is either exactly right or completely wrong as a piece of writing. Dana has to communicate it to four different audiences this week. Watch what changes. Notice that the facts never change. Only the framing, the order, the vocabulary, and the depth change — because the readers change.
Audience 1 — A fellow data scientist (expert)
K-R-A-C: High domain knowledge, high jargon fluency, shared context. Goal: verify the method and possibly reuse it. Action: trust the result enough to build on it, or push back on the methodology. Context: studies it carefully; friendly but rigorous; read now and possibly later as reference.
For this reader, jargon is not a barrier — it is precision, and removing it would be a loss. This reader wants to know it was a random forest and not a logistic regression, because that tells them something about how to interpret the feature importances. Define nothing they already know; that would insult them and waste their time.
To: Priya (DS team)
Subject: Churn driver analysis — onboarding time-to-value, methodology
Priya — wanted your eyes on this before I socialize it.
TL;DR: TTFV is the dominant churn predictor for <90-day accounts.
RF feature importance is unambiguous; partial-dependence is monotonic
and steep past ~14 days.
Method: random forest (sklearn, 300 trees, max_depth tuned via 5-fold CV)
on the new-account cohort (n=4,812, two-quarter window). Target = churn
within 90 days. Class imbalance handled with balanced subsampling;
ROC-AUC 0.81 on held-out. Top feature by a wide margin is time-to-
first-value (days). Buckets: <7d → 3% churn; >21d → 22%.
Caveat: TTFV correlates with plan tier (r≈0.3), so some of this could
be confounded — bigger accounts onboard slower. I controlled for tier
and the effect holds, but I'd value a second look at the interaction.
Notebook + data dictionary in the repo.
Notice: the method leads, because for a peer the method is the credibility. The caveat about confounding is front-and-center, because a peer's job is to find exactly that kind of hole and Dana respects them by raising it first. Nothing is dumbed down. This document would be a disaster for any other reader on this list.
Audience 2 — The VP of Marketing (manager / decision-maker)
K-R-A-C: Low jargon fluency, moderate domain knowledge, high business context. Goal: decide where to spend retention budget and defend that decision upward. Action: approve reallocating budget toward onboarding. Context: skims, on a phone, between meetings; friendly but time-starved; reads it once.
This reader does not care that it was a random forest. Mentioning it costs Dana credibility, not gains it, because it signals "this person doesn't know what I need." The VP needs the decision-relevant fact first, in business language, with a recommended action.
To: Renée (VP Marketing)
Subject: Why we're losing new customers — and the fix (1 number)
Renée — short version, then detail below.
The problem: we're losing nearly 1 in 4 new customers, and it's getting
worse (churn nearly doubled in two quarters). The cause isn't price and
it isn't the product. It's onboarding. Customers who don't get value in
their first week leave; customers who do, stay.
The number that matters: new customers who reach their first "win" in
the product within 7 days churn at 3%. Those who take longer than 3 weeks
churn at 22% — seven times higher.
The recommendation: move retention spend upstream, into the first-week
onboarding experience. The leak is in week one, not at renewal. I can
put a one-page plan in front of you by Friday.
(Happy to walk through the analysis if useful — the headline is above.)
Notice: the recommendation and the single decisive number lead. No "TTFV," no "random forest," no AUC. The word "churn" survives because Renée knows it — that's a context call, not a default. The structure is built for a thirty-second skim: bolded problem, the one number, the action. This is the version that returns in Chapter 27, where we'll rebuild it from methodology-first (worst) to recommendation-first (best). For now, see only this: it is the same finding as the email to Priya, and it shares almost no sentences with it.
Audience 3 — An external client (paying customer, semi-technical)
Now suppose the company sells onboarding-analytics services, and Dana must explain a similar finding to a client's project lead. The relationship changes everything.
K-R-A-C: Moderate domain knowledge, low-to-moderate jargon, low context (it's their business but our analysis). Goal: feel confident they're getting expert value, and understand what to do. Action: trust the recommendation and approve the next phase of work. Context: studies it somewhat (it's their money), neutral-to-friendly, possibly shared with their boss — so it must survive being forwarded.
The client document carries an extra burden the internal ones don't: it must demonstrate competence and respect the reader's intelligence without drowning them, and it must be safe to forward to someone more senior whom Dana has never met.
Subject: Onboarding analysis — findings and recommended next steps
Hi Elena,
Thank you for the data access — here's what we found and what we suggest.
WHAT WE FOUND
The strongest driver of early cancellations in your new-customer base is
how quickly customers reach their first meaningful result in the product.
Customers who get there within a week stay at very high rates; those who
take more than three weeks cancel far more often. This pattern is
consistent and strong enough that we're confident it's a real driver,
not noise.
WHAT IT MEANS FOR YOU
The opportunity isn't in pricing or features — it's in the first week.
Shortening time-to-first-value is the highest-leverage change available
to you right now.
RECOMMENDED NEXT STEPS
1. A focused audit of your current onboarding flow (we can run this).
2. Define and instrument a clear "first value" milestone you can track.
3. A/B test two faster onboarding paths against the current one.
We'd suggest starting with step 1; happy to scope it this week.
Notice the tone shifts: warmer, more "we," explicit gratitude, and a clear forward path framed as their opportunity. The methodology is summarized as a reassurance ("strong enough that we're confident it's real") rather than detailed, because the client wants to trust the expert, not audit them. And every sentence is forwardable — nothing Dana would be embarrassed to have land on the client's CEO's desk.
Audience 4 — The general public (a blog post or talk)
Finally, Dana writes a post for the company blog aimed at any founder or product manager, technical or not.
K-R-A-C: Low and unknown domain knowledge, near-zero jargon, no context. Goal: learn something useful and interesting; maybe share it. Action: understand the idea and apply the lesson to their own business. Context: skims on a phone, found via search or social, no obligation to keep reading past the first line.
This reader owes Dana nothing. They will leave the instant they're bored or confused. So the public version leads with a hook, uses an analogy instead of a metric, and spends its jargon budget carefully — perhaps two technical terms in the whole piece.
Why Your Customers Are Quitting in the First Week (and What to Do)
Imagine you buy a gym membership in January. If you go three times that
first week and one workout actually feels good, you keep going. If you
don't set foot in the place for a month, you cancel — and you blame the
price, even though the price was never the problem.
Software customers behave exactly the same way. We dug into thousands of
cancellations at [Company] and found something we didn't expect: people
weren't leaving because of cost or missing features. They were leaving
because they never got to the good part. Customers who hit their first
real "win" within a week almost never quit. Customers who took three
weeks or more quit seven times as often.
The lesson is uncomfortable, because it points at us, not the customer:
if people leave in week one, the leak is in the first week. Not your
pricing page. Not your feature roadmap. The first seven days.
So here's the one question worth obsessing over: how fast can a brand-new
customer get to a moment that makes them glad they signed up?
Notice: a story opens it, not a statistic. The gym analogy carries the entire technical idea (time-to-first-value) without the term ever appearing. "Seven times" survives because it's a vivid, memorable number, but "random forest," "cohort," "AUC," and "monotonic" are all gone — they would cost readers, not inform them. The piece even has a theme (the leak is on our side, not the customer's) because public writing needs an idea to hold onto, not just a result.
Put the four side by side
| Dimension | Expert (Priya) | Manager (Renée) | Client (Elena) | Public (blog) |
|---|---|---|---|---|
| Leads with | Method & result | Recommendation & key number | Finding + what it means | A story/hook |
| Jargon | Full, welcomed | Almost none | Minimal, reassuring | One analogy, ~0 terms |
| The "random forest" | Named and detailed | Omitted | Omitted | Omitted |
| Methodology depth | Deep (the credibility) | Skipped | One reassuring line | None |
| Caveats/confounders | Front and center | Cut | Softened to "we're confident" | Cut |
| Tone | Peer-to-peer, rigorous | Crisp, decisive | Warm, "we," forwardable | Conversational, vivid |
| Reader's next action | Verify / reuse | Approve budget | Approve next phase | Apply the idea |
| Length | Medium | Short | Short-medium | Medium |
🔍 Why Does This Work? Why does naming "random forest" help with Priya but hurt with Renée, when it's the same true fact? Think about what each reader does with the information before you read on.
Answer
Information is not neutral; it competes for the reader's limited attention against the thing they actually need. For Priya, the model type is decision-relevant — it changes how she interprets the result and whether she trusts it, so it earns its place. For Renée, the model type is decision-irrelevant — it can't change what he does next (approve budget or not), so it's pure cost: it burns a few seconds of his thirty, and worse, it signals that Dana doesn't understand what he needs. The skill isn't "use less jargon" or "use more." It's matching every piece of information to whether this reader can use it. Same fact, opposite value, because value is relational.
2.4 The Same Move, A Software Example
The four-audiences principle isn't a business-writing quirk. It governs technical documentation just as hard. Take a single event — a production service went down for 40 minutes because a database connection pool was exhausted — and watch it become different documents for different readers. This matters most on the 📗 Software/CS track, but the pattern is universal.
For the on-call engineer, during the incident (a runbook entry):
SYMPTOM: API returning 503s, p99 latency spiking, "connection pool
exhausted" in app logs.
DO THIS FIRST: Restart the connection pool — `svc restart db-pool`.
This restores service in ~30s. (It does NOT fix the root cause.)
THEN: Check open connections — `db-stats --open`. If >450, a query is
leaking connections; see "Leaking queries" below.
Terse, imperative, action-first. The reader is stressed and needs the fix now, not the explanation. Knowledge is high, context is "everything is on fire," action is "restore service," reading mode is "grab the one command."
For the engineering team, after the incident (a post-mortem):
## Incident: API outage, connection pool exhaustion (40 min)
ROOT CAUSE: A query added in PR #1843 omitted a `.close()` in its error
path. Under a spike of malformed requests, failed queries leaked
connections until the pool (max 500) was exhausted, causing cascading
503s across all endpoints sharing the pool.
CONTRIBUTING FACTORS: Pool exhaustion had no alert; we found out from
customer reports. Staging didn't reproduce because it doesn't receive
malformed traffic.
CORRECTIVE ACTIONS:
1. Fix the leak (PR #1851, merged).
2. Add a pool-utilization alert at 80%. [owner: Sam, due Fri]
3. Add a connection-leak lint rule. [owner: Dana, due next sprint]
Now it's reflective and causal: why it happened, what we'll change, with owners and dates. The reader is a colleague learning so it doesn't recur — not a panicked responder. Same outage, different job, different document.
For the customer, after the incident (a status-page update):
Resolved — API Degradation (Jan 14, 14:02–14:41 UTC)
Between 14:02 and 14:41 UTC, some API requests failed or were slow. We
identified the cause — a database resource limit triggered by an unusual
traffic pattern — and resolved it by restarting the affected component
and deploying a fix. We've added monitoring to catch this class of issue
earlier. We're sorry for the disruption.
No PR numbers, no "connection pool," no internal blame. The customer needs honesty, reassurance, and confidence it won't recur — not a code review. "Connection pool exhaustion" becomes "a database resource limit." That's not lying; it's translating to the reader's knowledge level. The technical reader on the post-mortem would feel cheated by this vagueness; the customer would feel overwhelmed by the alternative. Each is right for its reader.
🧩 Productive Struggle Before reading on, try this yourself. A bridge inspection finds a corroded support beam that needs replacement within six months. Write the opening sentence of two documents: (1) an engineering report for the structural team, and (2) a notice to the city council that controls the budget. Don't write the whole thing — just the first sentence of each, and notice how different they have to be.
One reasonable approach
To the structural team: "Support beam B-7 (north abutment) shows section loss exceeding 30% from chloride-induced corrosion and must be replaced within six months to maintain the load rating." — Precise, jargon-rich, leads with the technical fact and the deadline.
To the city council: "One of the bridge's main support beams has corroded to the point that it must be replaced within six months, at an estimated cost of $X, to keep the bridge safe and open." — Leads with the consequence and the decision (cost, safety, the clock), in plain language, because the council's job is to fund it, not to inspect it. Note: the urgency and the core fact are identical; only the vocabulary and what-leads change. The temptation to soften the deadline for the council would be an ethics failure — clarity about danger is non-negotiable (a thread we pick up in Chapter 38).
2.5 The Curse of Knowledge: Why Experts Write Badly for Non-Experts
You now know you should adapt to your reader. So why is it so hard to actually do it? Because of a cognitive trap that gets worse the more expert you become.
In 1990, a Stanford graduate student named Elizabeth Newton ran a now-famous experiment. She had people "tap" the rhythm of a well-known song — "Happy Birthday," say — on a table, while a listener tried to name the tune. Tappers first predicted how often listeners would guess right. They predicted about 50%. The actual rate was around 2.5%. The tappers heard the full song in their heads — melody, lyrics, the works — and could not imagine that the listener heard only a meaningless series of taps. Once you know the tune, you cannot un-know it, and you systematically overestimate how obvious it is to someone who doesn't.
That is the curse of knowledge, and it is the single biggest reason smart people write badly for non-experts. When you understand a system deeply, the connections feel obvious. The jargon feels like plain English. The three steps you skipped feel too trivial to mention. You are not being arrogant. Your brain is genuinely unable to reconstruct the state of not-knowing. The chip designer thinks "DMA" is a normal word. The doctor thinks "presents with" is how everyone talks. The engineer thinks the conclusion is obvious because to them it is.
The Challenger engineers had it. The connection between cold temperature and O-ring failure was, to them, the whole point — vivid, central, alarming. They could not fully feel how non-obvious it was to managers reading hastily-assembled charts under deadline pressure. The curse doesn't make you wrong. It makes you unable to see why others don't immediately agree.
🚪 Threshold Concept: There is no "good writing," only writing that is good for a reader.
Before you cross this threshold, you think of writing quality as a property of the text — some writing is "good," some is "bad," and you improve by making your text more "good." You polish sentences in a vacuum.
After you cross it, you understand that quality is a relationship between a text and a reader doing a task. A sentence that is brilliant for one reader is useless for another. There is no view from nowhere. You stop asking "is this good?" and start asking "is this good for this reader, doing this thing, in this much time?" This reframes every other skill in the book: clarity, structure, word choice, and design are all relative to an audience, never absolute.
This is a threshold concept because it is hard to un-see once seen, and because it quietly rewires how you read your own drafts. You will catch yourself, mid-sentence, asking "for whom?" That instinct is the whole game. We will deliberately revisit it in Chapters 4, 7, and 27.
Tactics to break the curse
Awareness alone won't save you — the curse operates below awareness. You need mechanical tactics that force the reader's perspective into view. Here are the reliable ones.
1. Name the jargon. Before you draft, list every term, acronym, and concept your document leans on. Look at the list with the reader's eyes. For each item, decide: keep (they have it), define (they need it, on first use), or replace (find a plainer word). The act of listing externalizes what's invisible inside your head. You can't audit jargon you can't see, and the curse keeps it invisible until you write it down.
❌ Before (the curse, unexamined): "We deprecated the legacy endpoint and the client must migrate to the v2 API before EOL or requests will 401." ✅ After (jargon named and handled for a non-engineer): "We're retiring the old system. Any software still using it needs to switch to the new version by [date]; after that, the old version stops accepting requests." Why it's better: Every term that the reader lacks ("deprecated," "endpoint," "v2 API," "EOL," "401") was either replaced or made concrete. Nothing was dumbed down — the information is identical — but the doors stopped slamming.
2. Define on first use. When you must keep a term, define it the first time it appears, in-line, without making a production of it. "...the model's time-to-first-value (how many days before a new customer does something meaningful in the product)..." One parenthetical. The expert reader's eye skips it; the novice reader is rescued by it. This single habit — define-on-first-use — prevents more confusion than any other, because the most common failure mode is not wrong information but undefined terms.
3. The smart-friend test. Imagine explaining your finding out loud to a smart friend in a different field — a sharp person, but not your expert. What do you instinctively skip or simplify when you talk to them? Those are exactly the moves your writing needs. Speech forces audience adaptation that writing lets you dodge; you'd never say "the random forest's partial dependence is monotonic" to your friend at dinner, so don't write it to a reader who is, for this purpose, that friend. (This is sometimes called the "explain it to your smart cousin" move; the cousin is a stand-in for any capable non-specialist.)
4. Test on a real non-expert. The gold standard. Hand your draft to someone in your target audience — or close to it — and watch where they slow down, frown, or reread. You are not asking "is this good?" (they'll be polite). You are watching for the physical signs of friction. Every place their eyes snag is a place the curse hid a problem from you. If you can't get a real reader, the smart-friend test is the simulation; a real reader is the real thing.
5. Wait, then reread as a stranger. Time creates distance. A draft reread after a night's sleep is read by a slightly different person — one who has partly forgotten the context and so partly approximates the reader who never had it. The gaps you couldn't see yesterday become visible. (This connects to the revision discipline of Chapter 12: distance is a tool.)
🔄 Check Your Understanding The curse of knowledge predicts a specific, counterintuitive pattern: who is more likely to write an impenetrable explanation of a topic — a world expert or someone who learned it last month? Why?
Answer
The world expert. The person who learned it last month still partly remembers what confusion felt like — they recently stood where the reader stands, so they instinctively define terms and spell out steps. The expert has fully internalized the material; the not-knowing state is no longer accessible to them, so they skip the very things a novice needs. This is why "explained by someone who just figured it out" is often clearer than "explained by the leading authority," and why experts must use deliberate tactics (above) to compensate for a disadvantage they don't feel.
2.6 Audience and Purpose Are Linked: The Four Things Writing Does
There is a second half to audience analysis that writers routinely skip: purpose. Once you know who is reading, you must know what you're trying to do to them — and there are really only four answers. Naming your purpose prevents the most common structural mistake in technical writing: defaulting to "inform" when the situation actually calls for "persuade."
Inform. You're transferring knowledge, neutrally. A status report, a reference doc, a methods section. The reader's question is "what is the case?" Your job is accuracy and findability; you are not arguing, just reporting. Most reference documentation is pure inform.
Persuade. You're changing what the reader believes or decides. A proposal, a business case, a recommendation memo. The reader's question is "what should I do, and why should I believe you?" Your job is argument: evidence, logic, addressing objections, leading with the claim. The Challenger memo needed to be persuasive and was structured to merely inform — that mismatch is the whole tragedy.
Instruct. You're enabling the reader to do something. A tutorial, an SOP, an installation guide. The reader's question is "how do I do this?" Your job is correct, ordered, testable steps that work even when the reader skips ahead or has never done this before. (Chapter 22 lives here.)
Record. You're creating a durable account for the future or for accountability. Meeting minutes, an incident log, an ADR, a lab notebook. The reader's question is "what happened, and why was it decided this way?" — often asked by someone (maybe future-you) you'll never meet. Your job is completeness and traceability, not persuasion or elegance.
The mistake is treating every document as "inform." Dana's memo to Renée is not inform — if it merely informed him of the churn numbers, he'd nod and do nothing. It must persuade him to move budget, which is why it leads with a recommendation. The runbook is not inform — it must instruct, which is why it's imperative ("DO THIS FIRST") not descriptive. The post-mortem is partly record (so it's never lost) and partly persuade (so the fixes actually get prioritized).
| Purpose | Reader's question | Leads with | Structure | Example |
|---|---|---|---|---|
| Inform | "What is the case?" | The key fact | Logical / findable | Status report, reference docs |
| Persuade | "What should I do?" | The claim / recommendation | Argument: claim → evidence → objections | Proposal, recommendation memo |
| Instruct | "How do I do this?" | The goal, then step 1 | Ordered, testable steps | Tutorial, SOP, install guide |
| Record | "What happened / why?" | Context, then the account | Complete, traceable, dated | Minutes, incident log, ADR |
Purpose and audience interlock. The same audience can need different purposes (Renée needs persuade today and record — the minutes of the decision — next month). And the same purpose lands differently for different audiences (persuading a peer uses methodology as evidence; persuading an executive uses business impact). You always answer both questions: who, and to do what.
✏️ Try This: Take the last important document you wrote. Name its purpose in one word from the four above. Now ask: did its structure match that purpose? If you wrote a persuade-document but buried the recommendation at the bottom (informing first, recommending last), you just diagnosed why it underperformed.
2.7 The Challenger Memos: A Failure of Audience Adaptation
We opened with that night in January 1986. Now you have the tools to see precisely what went wrong — not as a tragedy to gawk at, but as the most rigorously documented case of writing for the wrong audience in the historical record. (The facts here are well established by the Rogers Commission report and Edward Tufte's later analysis; we keep strictly to that record.)
The night before the launch, engineers at the contractor Morton Thiokol — who built the solid rocket boosters — raised an alarm. The boosters were sealed by rubber O-rings, and the engineers had data suggesting that O-rings lost resilience in cold weather. The forecast for launch morning was unusually, dangerously cold. The engineers initially recommended against launching. In a now-infamous teleconference, that recommendation was questioned, and under pressure the recommendation was reversed. The shuttle launched at about 36°F. An O-ring failed. Seven astronauts died.
The engineers were right. So why did the warning fail? Part of the answer is organizational pressure, which is real and which we won't pretend away. But a large part is communication — specifically, a failure to adapt the message to the audience that had to act on it.
The audience mismatch. The engineers presented their case largely the way engineers present to engineers: charts dense with technical detail, organized around the data they had collected, with the alarming conclusion distributed across thirteen charts rather than stated, once, unmissably, up front. The decision-makers in the room were managers under schedule pressure who needed one thing: a clear, undeniable, decision-ready answer to "is it safe to launch tomorrow at this temperature?" They got engineering documentation. They needed a persuasive decision memo. Those are different documents, and the gap between them is where the argument was lost.
The buried conclusion. Tufte's analysis showed that the single most important relationship — O-ring damage as a function of temperature — was never presented in one clear chart that a tired, skeptical decision-maker could absorb in seconds. The evidence existed; it was scattered. Run our framework backward and you can see every variable mis-set: the knowledge level of the audience was treated as expert when the relevant readers needed translation; the action required (halt the launch) demanded a persuade document and got an inform one; the context — exhausted people, immense pressure, minutes to decide — called for a single unmissable conclusion and got thirteen charts.
This is the lesson, stated plainly: being right is not enough. The engineers' analysis was correct. Their writing — as an act aimed at a specific audience that had to make a specific decision under specific constraints — did not do its job. Adapting to your audience is not a "soft skill" or a nicety. In this case it was, literally, a matter of life and death. Most of the time the stakes are lower. But the principle never changes: the document that helps no one might as well not exist, no matter how correct it is.
We will return to Challenger in Chapter 4 (how structure buries or surfaces a conclusion), Chapter 9 (Tufte on how the visuals failed), and Chapter 38 (the ethics of communication when lives are at stake). For now, hold one idea: the engineers didn't lose because they were wrong. They lost because they wrote for themselves.
📐 Project Checkpoint: Write an Audience Profile for Your Portfolio Topic
In Chapter 1 you chose a technical topic you know well — the seed of your Communication Portfolio, the seven-piece collection of professional writing you'll build across this book. (If you skipped that, choose now: a technology you understand, a project you did, a method you can explain. You'll write about it many times, so pick something with real substance.)
This chapter's increment is not a draft. It's the thinking that makes every future draft easier: an audience profile. You are going to commit, on paper, to a specific reader. Most writers carry a vague reader in their head and pay for it later. You're going to make yours explicit.
Your task (write ~250–400 words):
-
Choose your primary audience for the portfolio. Your portfolio will eventually contain documents for different readers (a technical report, a memo, a blog post), but choose one primary reader you'll keep returning to — ideally someone with moderate-to-low expertise in your topic, because writing for them stretches you more than writing for peers. Name them concretely: not "managers" but "a product manager who is smart, busy, non-technical, and has to decide whether to fund my project."
-
Run the full K-R-A-C framework on them, in writing, using the worksheet from §2.2. Don't just fill blanks — write a sentence or two on each: - Knowledge: What do they know about your topic? What three or four terms will you have to define or replace? - Role/goal: Who are they and why would they read about your topic? - Action: Complete "After reading my portfolio piece, this reader will ____." Make it an action, not a vibe. - Context: Skim or study? Screen or print? Friendly, neutral, or skeptical?
-
Name a secondary audience in one sentence — someone else who might read it (e.g., the primary reader's boss, a future teammate). Note one way their needs differ from the primary reader's.
-
Identify your purpose from §2.6's four (inform / persuade / instruct / record). One word, then one sentence on why.
Keep this profile. Every checkpoint from here forward will reference it — when you draft the report, the memo, the blog post, you will pull this out and write to this reader. In Chapter 3, you'll take a paragraph about your topic and cut it for clarity; you'll cut it for the reader you just profiled, because clarity, like everything else, is relative to an audience.
Preview of the next increment: In Chapter 3 (Clarity), you'll draft a short, honest first pass explaining your topic — and then we'll cut its word count by a third without losing a single idea, the first real before/after of your own writing.
2.8 Common Mistakes & Practical Considerations
Knowing the framework is one thing; the failures show up in the gaps between knowing and doing. Here are the ones that bite real writers.
Mistake 1: Treating "audience analysis" as a one-time formality. Writers run the framework once, then draft on autopilot and drift back to writing for themselves by paragraph three. The fix is mechanical: keep the audience profile visible while you draft — a sticky note, a comment at the top of the doc. The curse of knowledge pulls you back toward your own perspective constantly; you have to keep steering.
Mistake 2: Confusing "simpler" with "dumbed down." Adapting for a non-expert does not mean removing information or talking down. It means translating — same content, different vocabulary and order. Dana's blog post contains the identical finding as her note to Priya. If your "audience-adapted" version is missing the actual point, you didn't adapt; you gutted it. Respect the reader's intelligence; just don't assume their vocabulary.
Mistake 3: Forgetting the secondary audience. The person you're writing to is rarely the only person who reads it. An email to your boss gets forwarded to their boss. A client report lands on the client's CEO's desk. A Slack message is screenshotted. Ask: who else might read this, and would it survive that? Write the primary audience's document, but don't put anything in it that the secondary audience would weaponize or misread. (This is also a professionalism safeguard: never write what you'd hate to see forwarded.)
Mistake 4: The hostile-reader blind spot. Friendly readers forgive overstatement; hostile readers exploit it. If your document might reach a skeptic, a competitor, opposing counsel, or a reviewer hunting for flaws, every unsupported claim is ammunition. Write the version that survives an adversary reading it line by line for a weakness. Hedge what is genuinely uncertain; never overclaim.
Mistake 5: "I'll write it once and let everyone read it." The fantasy of the one document that serves all four audiences. It almost never exists, because the audiences' needs genuinely conflict — what the expert requires (methodology, caveats) is exactly what bores the executive. When you must serve multiple audiences in one artifact, layer it: an executive summary up top for the skimmer, detail below for the studier, an appendix for the expert. Structure lets one document hold several readers — a technique Chapter 4 builds out fully. But layering is a deliberate design, not the accident of hoping one flat document fits all.
Mistake 6: Assuming your audience is like you. The deepest version of the curse. You imagine a reader who knows what you know, cares what you care about, and reads the way you read. They almost never do. The single most useful corrective is the cheapest: ask a real person from the target audience to read it, and watch where they struggle. One real reader beats an hour of imagining.
The "it depends" cases. When you genuinely don't know your audience — writing for a public mailing list, an open-source README, a blog post that anyone might find — default to the least expert plausible reader for the framing and the hook, but layer in depth for the experts (a "details" section, links, an appendix). Findability lets each reader self-select their depth. And when audiences truly conflict and you can't layer, you may simply have to write two documents. That's not failure; that's Dana writing to both Priya and Renée. Two short right documents beat one long wrong one.
Frequently Asked Questions
How do I write for an audience I don't know?
Default to the least-expert plausible reader for your framing, hook, and vocabulary, then layer depth so experts can dig in: a clear summary up top, detail below, technical specifics in an appendix or behind links. This is how good READMEs, public docs, and blog posts work — they let each reader self-select their depth. If you can identify even a rough primary reader ("developers evaluating this library," "founders who found this via search"), run K-R-A-C on that rough profile; a rough profile beats none.
What if I have to write for two very different audiences at once?
First, try to layer one document: an executive summary for the skimmer, full detail below for the studier, an appendix for the expert. Structure (Chapter 4) lets a single artifact serve several readers. If the audiences' needs genuinely conflict and can't coexist — the expert wants methodology the executive will never read — write two documents. That's not a failure; it's exactly what Dana does for Priya and Renée. Two short, correct documents beat one long, compromised one.
Isn't simplifying for a non-expert the same as dumbing it down?
No, and the distinction is the whole skill. Dumbing down removes information or condescends. Adapting translates — keeps the full content, changes the vocabulary and order to fit the reader. Dana's blog post and her note to Priya contain the same finding; only the framing differs. If your simplified version is missing the actual point, you gutted it instead of adapting it. Respect the reader's intelligence; just don't assume their jargon.
How is the curse of knowledge different from just being a bad writer?
The curse of knowledge is specific and predictable: the more expertly you know something, the less able you are to imagine not knowing it, so you skip definitions and steps that feel obvious to you but aren't to the reader. It hits good writers and brilliant experts hardest — which is why deliberate tactics (name the jargon, define on first use, test on a real non-expert) matter. You can't fix it with effort or talent alone; you fix it with mechanics that force the reader's perspective into view.
Does audience analysis really matter for short stuff like emails and Slack messages?
Especially there. Short documents have no room to recover from a wrong assumption — there's no later paragraph to clarify. The email that opens with three sentences of context the reader already has, or jumps to a request the reader has no framing for, fails in its first line. The four-part question takes fifteen seconds for an email and routinely doubles its response rate. Chapter 19 applies this directly to email.
Chapter Summary
Key Takeaways
- There is no "good writing" in the abstract — only writing that is good for a specific reader, doing a specific task, in a specific amount of time. Quality is a relationship, not a property of the text.
- Analyze every audience with K-R-A-C: Knowledge (what they know), Role/goal (why they read), Action (what they'll do after), Context (how they read — skim/study, screen/print, friendly/hostile, now/later).
- The same finding becomes four genuinely different documents for an expert, a manager, a client, and the public. The facts stay constant; the framing, order, vocabulary, and depth change with the reader.
- The curse of knowledge makes experts overestimate what readers understand. It operates below awareness, so you defeat it with mechanics, not willpower: name the jargon, define on first use, the smart-friend test, and testing on a real non-expert.
- Match purpose (inform / persuade / instruct / record) to the situation. The classic failure is defaulting to "inform" when you needed to "persuade" — the Challenger mistake.
Action Items
- Before your next document, fill out the K-R-A-C worksheet (§2.2). Two minutes.
- List every term your document depends on; mark each keep / define / replace.
- Complete the sentence "After reading, the reader will ____" with an action, not a vibe.
- Have one real person from your target audience read your next important draft and watch where they slow down.
Common Mistakes
| Mistake | Fix |
|---|---|
| Analyzing audience once, then drifting back to writing for yourself | Keep the audience profile visible while drafting |
| Confusing "simpler" with "dumbed down" | Translate (keep content, change vocabulary), don't gut |
| Forgetting the secondary audience (forwarders, bosses) | Ask "who else reads this?"; never include what they'd weaponize |
| Defaulting every document to "inform" | Name the purpose; if it's persuade, lead with the recommendation |
| Imagining a reader who's just like you | Test on a real non-expert; one reader beats an hour of guessing |
Decision Framework: Which Version Do I Write?
| If the reader is… | Lead with… | Jargon | Purpose usually |
|---|---|---|---|
| A peer/expert | Method and result | Full | Inform |
| A manager/decision-maker | The recommendation + the one key number | Almost none | Persuade |
| A client | The finding + what it means for them | Minimal, reassuring | Persuade / inform |
| The general public | A hook or analogy | A term or two, max | Inform (engagingly) |
Spaced Review
A few questions reaching back, to strengthen retention.
- (From Chapter 1) Chapter 1 argued that "writing is thinking" — that you don't fully know what you think until you write it down. How does audience analysis connect to that idea? (Hint: what does choosing a specific reader force you to figure out about your own material?)
- (From Chapter 1) Chapter 1 made a career argument: communication is the #1 gap employers name in STEM graduates and a major predictor of advancement. Using this chapter's framework, why might a technically brilliant person still stall in their career — what specific writing failure does the curse of knowledge predict for them?
- (Bridging, Ch 1 → Ch 2) Chapter 1 introduced the before/after method as the book's core teaching device. In this chapter, what single variable most often decides whether a given "before" should become a particular "after"? Why can't you fix a "before" without knowing it?
Answers
1. Choosing a specific reader forces you to figure out *what your material actually means for them* — which forces you to understand it more deeply than you did when it was just facts in your head. Writing the manager version of Dana's finding requires her to know the *business implication*, not just the statistics; she has to think harder, not less, to translate. Audience analysis is "writing is thinking" aimed at a target: it makes you discover the parts of your understanding that matter to someone else. 2. The curse of knowledge predicts they will write for readers like themselves — packing documents with methodology and jargon that peers love but decision-makers, clients, and the public can't use. Their brilliant analysis helps no one who controls budgets, opportunities, or promotions, because those people can't extract value from it. They're right and unheard, like the Challenger engineers. Career advancement increasingly depends on communicating *across* expertise levels, and the curse sabotages exactly that. 3. **The audience.** A "before" can only become the *right* "after" once you know who the reader is — the same weak paragraph should be cut, expanded, restructured, or completely reframed depending on whether it's headed to a peer, a manager, or the public. There is no audience-free improvement, because "improvement" means "better *for someone*." This is why this chapter precedes the clarity, structure, and design chapters: audience is the variable they all depend on.What's Next
You now know who you're writing for and what you're trying to do. Chapter 3 takes the next step: Clarity — how to say what you mean in the fewest possible words. Armed with your audience profile, you'll learn to cut jargon that doesn't serve the reader, kill the bloat that hides in every first draft, choose strong verbs over limp nominalizations, and apply the "so what?" test to every sentence. It's the chapter that most directly transforms your writing line by line — and it only works because you now know the reader you're being clear for.
Practice: Exercises · Quiz Go deeper: Case Study · Case Study 2 Review: Key Takeaways · Further Reading