Get AI summaries of any video or article — Sign up free
Kelly O'Brien - Surprise! You're a designer now. thumbnail

Kelly O'Brien - Surprise! You're a designer now.

Write the Docs·
5 min read

Based on Write the Docs's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Content design is a product discipline focused on structuring and presenting information, not just writing copy at the end.

Briefing

Content design is a product discipline focused on structuring and presenting information—and its real value shows up when teams involve it early, before “roof-level” copy work starts. Kelly O’Brien, who works on Intercom’s content design team, argues that most of the heavy, high-impact thinking in content design happens beneath the surface: defining concepts, mapping relationships, and building information architecture. The visible output—UI copy and written words—often takes only a small slice of time, yet it’s what teams react to last, when decisions are already locked in.

That mismatch creates predictable friction. When product work is “ready to ship” but copy hasn’t been planned, content designers (and documentarians, UX writers, and others responsible for language) get pulled in at the last minute. They then face deep questions—what is this thing, how does it relate to other concepts, what are the names in the code, and how do we keep similar ideas distinct. If those questions weren’t answered earlier, simple communication becomes impossible, leading to frustration on both sides: designers can’t do their job well without context, while engineers and others resent rework that forces them to revisit weeks of decisions.

To fix that pattern, O’Brien offers a metaphor: building a product like building a house. The “roof” is the surface-level writing; the “foundation” is the system model where objects and relationships are defined; the “walls and windows” are information architecture and interaction points; and the “roof” is where copy goes. The central claim is that content design should be involved at each stage, not just when words are needed. When content design participates from the foundation upward, the product’s structure supports consistent terminology, coherent narratives, and copy that matches the system’s definitions.

O’Brien breaks down the risks at each level using a help-center example. At the system-model stage, the risk is unclear or inconsistent object definitions—such as how frequently asked questions should be represented. Teams might choose between creating a dedicated “FAQ” content object (with its own properties like question/answer and potentially tagging) or treating FAQs as a type of article with a lighter-weight distinction. Early clarity matters because later layers—information architecture, editing workflows, and user navigation—must build on the same shared understanding.

At the information-architecture stage, the risk is a “floor plan” that can’t support the intended experience. If FAQs are distinct objects, the management and navigation structures may need separate sections; if FAQs are just article types, everything can remain within the existing category and editing model.

At the interaction-design stage, the risk is mismatched UI behavior—such as editing experiences that don’t reinforce the underlying system choices. Distinct content objects can justify distinct editing fields and shorter answer-focused input patterns, while article-type FAQs may only require a checkbox or dropdown.

Finally, at the roof level, the risk is “copy that doesn’t do its job.” O’Brien argues that early foundation work makes roof-level writing easier and more successful because the system model supplies nouns and definitions, information architecture supplies narrative structure, and interaction design supplies verbs and task flows.

The practical takeaway is not to treat content design as extra work, but to advocate for earlier involvement. O’Brien recommends building relationships with product teams, securing a seat at one key meeting per project, and communicating the content-design perspective through quick diagrams (she cites Whimsical) that make the “foundation-to-roof” logic easier to act on. The payoff: fewer last-minute rewrites, better quality, and a smoother path from structure to language.

Cornell Notes

Content design is a product discipline that structures and presents information, and its biggest impact comes from early involvement. O’Brien argues that teams often wait until “roof-level” copy is needed, when the underlying system model, information architecture, and interaction design are already set—making clear communication difficult and creating frustration. Using a house-building metaphor, she maps content design work across foundation (system model), walls (information architecture), and windows/doors (interaction design), culminating in UI copy. A help-center example shows how early decisions—like whether FAQs are a separate content object or an article type—should drive later navigation, editing workflows, and interaction patterns. Early clarity leads to easier, more accurate writing and a better user experience.

Why does content design often get pulled in too late, and what goes wrong when that happens?

O’Brien describes a common workflow where product teams reach a point where shipping is imminent, then realize copy is missing. Content designers (or documentarians/UX writers) get asked to “put words on” without earlier alignment on concepts, relationships, and naming. That forces last-minute deep questioning—what the new thing is, how it relates to existing concepts, and how it’s represented in code. Without prior clarity, teams either produce weak copy or trigger rework that engineers and others resist, creating frustration on both sides.

What is the “house” metaphor, and how does it map to content design work?

The metaphor treats product building like constructing a house. The “roof” is the visible writing work (UI copy and other surface-level language). The “foundation” is the system model: mapping objects and relationships. “Walls and windows” correspond to information architecture and interaction points—how users group, navigate, and experience content. When content design participates from foundation through interaction design, the final roof-level copy can sit cleanly on a coherent structure.

How does the help-center example illustrate the system-model risk?

The example starts with categories and articles (title, body, author, status). Customers want FAQs too, with different needs. Content design at the system-model level asks whether FAQs should be a separate content object (with properties like question and answer, plus possible tagging) or just a type of article (e.g., long-form vs FAQ, possibly with a lighter distinction). Early clarity determines whether later layers treat FAQs as truly distinct or as a variation within the same object model.

How does information architecture change depending on whether FAQs are separate objects or article types?

If FAQs are separate content objects, information architecture may create distinct sections for editing and navigation—one for articles and another for FAQs—reflecting their different management experience. If FAQs are merely article types, the information architecture can stay lighter: categories and all content types (including FAQs) can live together, allowing editing and management within the existing structure.

What does interaction design have to do with content design decisions?

O’Brien argues interaction design should reinforce system-level choices. With distinct FAQ objects, the editing UI can change meaningfully—separate question and answer fields and shorter answer-focused input patterns, plus tag management. With FAQ-as-article-type, interaction changes can be minimal—perhaps a checkbox or dropdown indicating the article type—because the underlying system distinction is lighter.

What makes roof-level copy easier when content design is involved earlier?

Early work supplies the raw material for writing. The system model provides definitions and the “nouns” (objects and concepts). Information architecture provides narrative structure and user journeys. Interaction design provides task flows and the “verbs” (what users do). With those aligned, naming and distinctions are already established, so UI copy can be written quickly and accurately.

Review Questions

  1. What specific last-minute questions does O’Brien say content designers face when copy is requested too late?
  2. In the house metaphor, what does the “foundation” correspond to, and why does that matter for “roof-level” writing?
  3. Using the help-center scenario, explain one reason FAQs might be modeled as a separate content object rather than an article type.

Key Points

  1. 1

    Content design is a product discipline focused on structuring and presenting information, not just writing copy at the end.

  2. 2

    Most high-impact content design work happens beneath visible outputs like UI copy—especially mapping concepts and relationships.

  3. 3

    Last-minute requests for copy create predictable failure modes because teams haven’t aligned on definitions, naming, and distinctions.

  4. 4

    Involve content design from the system model through information architecture and interaction design so roof-level writing can match the product’s structure.

  5. 5

    Early system-model decisions (e.g., whether FAQs are separate objects or article types) should drive later navigation, editing workflows, and interaction patterns.

  6. 6

    Advocate for earlier participation by building relationships, joining one key ideation meeting per project, and communicating using quick diagrams (e.g., Whimsical).

Highlights

The “roof” metaphor reframes copywriting as the final layer of a larger structure: system model → information architecture → interaction design → writing.
When content design is delayed until shipping time, teams end up with either weak copy or costly rework because core concept questions were never answered.
A help-center example shows how modeling FAQs as separate objects vs article types changes everything from tagging to editing UI to navigation structure.
Early alignment turns writing into a straightforward output of prior definitions and task flows, rather than a scramble for clarity at the end.

Topics

Mentioned

  • Intercom
  • Kelly O'Brien
  • Sarah Richards
  • Meredith Castile
  • Dan Olson
  • Sam Vine Garten