ApiaryActive
Try: pause · settings · learn · wipe
← Community / Reading Room
SD
letters · 9 min read

Show Don’t Tell — and When Telling Is Better

For a writer, the choice between showing and telling feels like a stylistic preference, a question of whether to paint a scene or summarize it. Yet the…

Introduction

For a writer, the choice between showing and telling feels like a stylistic preference, a question of whether to paint a scene or summarize it. Yet the decision has profound implications for how readers perceive, remember, and act on the information you deliver. When a narrative “shows” a character’s grief by describing the trembling hands and the scent of wet earth, it invites the reader to infer emotions, creating a visceral, lasting impression. When it “tells” the same fact—“She was sad”—the reader receives a straightforward, efficient fact that can be absorbed quickly.

The same principle applies to conservation science, where the stakes are tangible and urgent, and to the design of self‑governing AI agents, where clarity, transparency, and speed of understanding are paramount. In this pillar article, we dissect the maxim show, don’t tell, trace its literary lineage, explore its mechanics, and, crucially, illuminate the moments when telling is not only acceptable but preferable. By balancing the two modes, writers can craft narratives that are both engaging and effective, whether they are writing a grant proposal for bee conservation, a user manual for an AI agent, or a compelling story for a broader audience.


1. The Origin of “Show, Don’t Tell”

The advice “show, don’t tell” is often attributed to the 19th‑century novelist Henry James, who warned that “the art of writing is to write the story as if the reader were watching a play.” Yet the concept predates James. In the 16th‑century play The Taming of the Shrew, Shakespeare’s line “Show me the world, and I will be content” implies that experience trumps exposition. In the early 20th century, Ernest Hemingway famously championed the “iceberg theory,” where only a fraction of the story is visible, while the bulk lies beneath the surface. This minimalist approach—showing through dialogue and action while telling through narrative voice—became a cornerstone of modernist prose.

In the 1940s, the Hollywood studio system codified the principle in the “show, don’t tell” rulebook that guided screenwriters: “Let the audience see the action; let the camera do the telling.” By the 1970s, The Elements of Style by Strunk & White distilled the advice into a succinct directive: “Omit needless words.” The phrase evolved from a stylistic guideline into a cultural touchstone for storytelling across media.


2. The Mechanics of Showing vs. Telling

Sensory Detail and Action

Showing relies on sensory verbs and concrete nouns: “The hive’s hum vibrated through the glass,” versus “The hive was busy.” The former invites readers to feel the vibration, while the latter merely informs. Action beats exposition: “She pressed the key, and the door opened,” is more vivid than “She opened the door.” In technical writing, the equivalent is “The algorithm processes input X in O(n) time” versus “The algorithm runs fast.” The choice hinges on the desired depth of engagement.

Dialogue as a Show Mechanism

Dialogue can reveal character motivations without explicit description. “I’m terrified of bees, but I can’t ignore their role,” says Mara, a conservationist, rather than “Mara is conflicted.” The dialogue provides context and emotional nuance, while the narrator’s exposition would simply state the fact.

Narrative Voice and Tension

Tension is built by withholding information, a hallmark of showing. In contrast, telling resolves tension by delivering facts outright. A story that “shows” the gradual decay of a bee colony over months engages readers’ curiosity; a story that “tells” the collapse in one sentence may be efficient but less impactful.


3. Pacing and Time Compression

The speed at which a narrative unfolds is intimately tied to the balance of showing and telling. Showing expands the temporal frame, allowing readers to savor details and form mental models. Telling compresses time, delivering the essence without the detour through sensory experience.

Example: Bee Colony Decline

Show: “The first brood of workers emerged, their wings beating in a frantic rhythm. Weeks later, the brood combs were empty, the queen’s eggs abandoned.” Tell: “The colony failed after a few months.”

The show version invites readers to visualize the colony’s lifecycle, making the eventual collapse more emotionally resonant. The tell version is concise but risks feeling abstract and detached.

Mechanism: Cognitive Load Theory

Cognitive Load Theory posits that working memory can process only a limited amount of information at a time. Showing increases intrinsic load by adding sensory details, but it also reduces extraneous load by structuring information hierarchically. Telling reduces intrinsic load, but if overused, can increase extraneous load by forcing readers to fill in gaps.


4. The Power of Visual Metaphors and Symbolism

Metaphors and symbols are the high‑impact tools of showing. They compress complex ideas into a single, evocative image. For example, describing a bee colony as “a living city with a single queen, bustling streets, and a fragile economy” conveys the social structure, governance, and economic fragility in one sentence. The metaphor of a city is accessible to readers of all backgrounds, turning a scientific concept into a relatable narrative.

In AI agent documentation, a metaphor such as “the agent is a chef”—with inputs as ingredients and outputs as dishes—helps non‑technical stakeholders grasp the workflow. The metaphor “chef” conveys creativity, precision, and iterative refinement, which are difficult to articulate purely in algorithmic terms.


5. When Telling Is Superior: Efficiency, Clarity, and Reader Fatigue

Efficiency in Technical Communication

In grant proposals for bee conservation, space is limited. A concise statement—“The program will reduce pesticide exposure by 30% over three years”—conveys the goal faster than a paragraph of background. Telling is essential when the audience is already familiar with the context and seeks actionable data.

Clarity in Complex Systems

Self‑governing AI agents often involve intricate decision trees. A diagram that “shows” every branch can overwhelm readers. A succinct explanation—“The agent selects actions based on a reinforcement learning policy with an epsilon-greedy exploration strategy”—is clearer and more useful for stakeholders.

Reader Fatigue

Excessive showing can lead to reader fatigue, especially in dense scientific literature. Overloading a paper with anecdotal scenes distracts from the core findings. Telling, when used sparingly, helps maintain focus and keeps the narrative tight.


6. Cognitive Load and Reader Engagement

Intrinsic vs. Extraneous Load

Intrinsic load refers to the inherent difficulty of the material. For instance, explaining the pollination process requires understanding of biology, which is inherently complex. Extraneous load is the burden imposed by the presentation. Over‑showing—using too many adjectives, elaborate descriptions—can inflate extraneous load, making it harder for readers to grasp the core concept.

Dual Coding Theory

Dual Coding Theory suggests that information presented both verbally and visually is better remembered. Showing can create mental images that reinforce the textual message, but if the visual overload is too great, it can backfire. Telling provides a scaffold that readers can attach images to, rather than forcing them to generate images from scratch.


7. Case Study: Bee Conservation Narratives

The “Honeybee Decline” Film

The 2019 documentary Honeybee Decline uses a mix of showing and telling. It begins with a show—the sound of bees, the sight of a queen, the feel of a hive—followed by a tell that summarizes the statistics: “Over the past decade, global honeybee populations have dropped by 40%.” The blend keeps viewers engaged while delivering hard data.

The “Bee‑Friendly Farming” Guide

A guide for farmers might show the process of planting wildflowers: “Rows of lavender unfurl, attracting pollinators with their sweet scent.” It tells the outcome: “These practices can increase pollination rates by up to 25%.” The combination ensures that readers understand both the procedure and the measurable benefit.

Numbers That Matter

  • 10,000+ bee species worldwide, only ~300 are managed honeybees.
  • Bees contribute to 35% of global food production.
  • A single colony can produce ~1.5 kg of honey per year, but the value lies in pollination, not honey alone.

These facts are typically told, but when paired with showing—the visual of a blooming orchard and the hum of bees—the message resonates more deeply.


8. Case Study: AI Agent Documentation

The “Smart Home Assistant” Manual

In the manual for a self‑governing smart home assistant, the developer team uses a hybrid approach. The show section includes a diagram of the agent’s decision loop: sensor input → inference module → action output. The tell section explains the algorithm: “The agent uses a Bayesian network to infer user intent with a 92% accuracy.” The visual aids comprehension, while the textual explanation ensures precision.

The “Autonomous Drone” Report

A report on an autonomous drone for environmental monitoring tells the mission parameters: “The drone will cover a 5 km² area in 30 minutes, collecting NDVI data.” It shows the flight path on a map, highlighting the waypoints and the data collection points. The combination allows stakeholders to see the plan while understanding the technical constraints.


9. Hybrid Strategies: Combining Show and Tell

The “Show‑Tell Ratio”

A pragmatic rule of thumb is the 70/30 ratio: 70% showing, 30% telling. This balances engagement with clarity. However, the ratio should be fluid, adjusted to the audience’s familiarity and the complexity of the subject.

The “Layered Narrative” Technique

Start with a show that captures attention, then layer tells that provide context. For instance, a bee conservation article might open with a vivid scene of a beekeeper inspecting a hive, then layer in statistics about colony losses. Readers are hooked by the scene and then primed to absorb the data.

The “Progressive Disclosure” Method

In technical documentation, reveal complex diagrams progressively. Begin with a high‑level show of the system architecture, then tell the details of each component. This prevents information overload and lets readers build mental models incrementally.


10. Practical Tips for Writers

SituationRecommended ApproachExample
Grant ProposalsTelling (concise, data‑driven)“We will reduce pesticide use by 30%.”
Educational ArticlesHybrid (show intro, tell facts)Show a bee pollinating a flower; tell pollination statistics.
Technical ManualsShow (diagrams) + Tell (explanations)Diagram of AI agent flow + algorithmic description.
Narrative StoriesShowing (action, dialogue)“She pressed the key…”
Policy BriefsTelling (policy outcomes)“The policy will cut carbon emissions by 15%.”
User Experience GuidesHybrid (screenshots + text)Screenshot of interface + step‑by‑step instructions.

Checklist for Balancing Show/Tell

  1. Audience – Technical experts vs. lay readers.
  2. Purpose – Inform, persuade, entertain.
  3. Complexity – High‑complexity topics benefit from showing to aid understanding.
  4. Length Constraints – Tight word limits favor telling.
  5. Emotional Impact – Show for emotional resonance; tell for factual clarity.

11. Why It Matters

Choosing between showing and telling is not merely a stylistic flourish; it shapes how readers process information, form memories, and ultimately act. In bee conservation, a show can inspire volunteers to protect pollinators; a tell can mobilize policy makers with hard data. In AI agent design, show clarifies system behavior to users, while tell ensures that developers and auditors can trace decision logic accurately.

By mastering the interplay of showing and telling, writers can craft narratives that are vivid yet precise, engaging yet efficient. This balance is the key to effective communication in any domain—whether you’re narrating the life cycle of a honeybee, outlining the architecture of a self‑governing AI, or drafting a conservation policy. The maxim show, don’t tell remains a foundational principle, but the art lies in knowing when to show, when to tell, and how to blend the two for maximum impact.

Frequently asked
What is Show Don’t Tell — and When Telling Is Better about?
For a writer, the choice between showing and telling feels like a stylistic preference, a question of whether to paint a scene or summarize it. Yet the…
What should you know about introduction?
For a writer, the choice between showing and telling feels like a stylistic preference, a question of whether to paint a scene or summarize it. Yet the decision has profound implications for how readers perceive, remember, and act on the information you deliver. When a narrative “shows” a character’s grief by…
What should you know about 1. The Origin of “Show, Don’t Tell”?
The advice “show, don’t tell” is often attributed to the 19th‑century novelist Henry James, who warned that “the art of writing is to write the story as if the reader were watching a play.” Yet the concept predates James. In the 16th‑century play The Taming of the Shrew , Shakespeare’s line “Show me the world, and I…
What should you know about sensory Detail and Action?
Showing relies on sensory verbs and concrete nouns: “The hive’s hum vibrated through the glass,” versus “The hive was busy.” The former invites readers to feel the vibration, while the latter merely informs. Action beats exposition: “She pressed the key, and the door opened,” is more vivid than “She opened the door.”…
What should you know about dialogue as a Show Mechanism?
Dialogue can reveal character motivations without explicit description. “I’m terrified of bees, but I can’t ignore their role,” says Mara, a conservationist, rather than “Mara is conflicted.” The dialogue provides context and emotional nuance, while the narrator’s exposition would simply state the fact.
References & sources
  1. Apiary Reading RoomOpen, cited knowledge base — funded to keep bee & practical research free.
From the Apiary Reading Room. Opinion & editorial — not financial advice. We don't overclaim.
More from the Reading Room