cd ../writing
// career · communication

Presenting engineering work — making it actually land.

Engineers undervalue presentation. The code works, the work is solid, surely the work speaks for itself. It doesn't. Brilliant engineering presented poorly is invisible — to your manager, to leadership, to the team that needs to adopt it. The patterns that make engineering work land aren't about salesmanship. They're about structure, audience, and what to leave out. This is the working guide for design docs, demos, and exec presentations.

3 formats 5 structural patterns real templates © use freely

01Start with the audience, not the work

The single highest-leverage habit when presenting: ask yourself who the audience is and what they need to walk away with.

Same work, three audiences, three different presentations:

  • Engineering peers: show the architecture, the trade-offs, the code. They care about how it works.
  • Engineering leadership: show the impact, the cost, the risks. They care about whether to support the project.
  • Non-engineering execs: show the business outcome, the timeline, the bottom line. They care about ROI and dependencies.

Presenting the engineering-peers version to execs is the most common failure. You're showing them what you built; they're asking themselves "why should I care?" Lead with what makes them care.

02Design docs — the structure that works

A design doc proposes how to solve a problem before you write the code. It's the highest-leverage written document in engineering — done well, it surfaces concerns early when changes are cheap.

The structure that works across companies:

✓ design doc template
# [Project Name] — Design

**Author:** [name]
**Status:** Draft / Review / Approved
**Stakeholders:** [list]
**Last updated:** [date]

## Summary
[2-3 sentences. What we're building. Why now.]

## Goals
- [bullet list of specific outcomes]

## Non-goals
- [explicit things we are NOT solving — preempts scope creep]

## Background
[Context the reader needs. Why does this problem exist?
Why are we solving it now?]

## Proposed solution
[The actual design. Architecture diagrams, API shapes, data
models, the meat of the doc.]

## Alternatives considered
[2-3 alternatives. For each: what it is, why we didn't pick it.
This is the single most important section — it shows you actually
thought about the problem.]

## Risks
[What could go wrong. Migration risks, performance risks,
correctness risks. Mitigations for each.]

## Timeline
[Rough phases. Not commitments — estimates with confidence.]

## Open questions
[Things you don't know yet. Inviting input.]

Three sections most engineers under-invest in:

  • Non-goals. The half-paragraph here saves weeks of scope creep later. Be explicit about what you're not doing.
  • Alternatives considered. Anyone can propose a solution. The signal of seniority is showing you considered 2-3 paths and chose the one with the best trade-offs.
  • Risks. Naming risks proactively builds credibility. Hiding them makes you look naive when they materialize.

03Demos — the structure that works

Most engineering demos are: "here's the feature, here's how it works, here's what I built." That's a tour, not a demo.

The demo structure that actually convinces people:

  1. Problem first (30 seconds). What was broken or missing. Make the pain visible — show the old way, the wasted time, the user frustration.
  2. The change (90 seconds). What the new experience is. Show it from the user's perspective, end to end.
  3. Why it works (30 seconds). The key technical insight that made it possible. Just enough to make the audience trust that the magic is real.
  4. What's next (30 seconds). What you'd build next if given the chance. Plants seeds for future work.

Three minutes total. Stop there unless they ask for more. Demos that run long lose attention; demos that respect time get follow-up questions.

04Executive presentations — the inversion

Engineering presentations are typically structured: background, methodology, analysis, conclusion. Executive presentations invert that order: conclusion first, then context.

Why? Execs are time-constrained. They want the bottom line, then the supporting details only if they need to dig in. By the third slide, they should know:

  • What you want from them (a decision, a resource, an approval)
  • Why it matters (in business terms, not engineering terms)
  • What you recommend

The classic "bottom line up front" structure:

✓ exec deck structure
Slide 1: The ask
  - One sentence: "We need approval for $X to do Y by Q3"

Slide 2: The recommendation
  - 3 bullets summarizing the path forward

Slide 3: The business case
  - Cost, benefit, timeline
  - In their units (revenue, customers, risk)

[Optional supporting slides if questions come up]

Slide N: Risks and mitigations
  - What could go wrong, what we're doing about it

15 minutes scheduled, 5 minutes of presentation, 10 minutes of discussion. If you talk for 15 minutes straight, you've taken away their decision time.

05Visuals — the rules

  • One idea per slide. If a slide contains two ideas, split it. Slides with three or more ideas don't communicate any of them.
  • Diagrams over bullets. Architecture diagrams, flow charts, before/after comparisons. They land far better than text.
  • Numbers in context. "$80K loss" is meaningless. "$80K loss representing 12% of quarterly revenue" lands.
  • Charts with one clear takeaway. If the audience can't state the chart's point in one sentence, redesign it.
  • No walls of text. If your slide is a paragraph, you wrote a document, not a slide. Move it to speaker notes.

06Async-first presentations

In the remote/hybrid era, the highest-leverage move is making your presentations work asynchronously. People who couldn't attend the meeting can absorb the same information from the doc alone.

How: write a real document. Slides are speaking aids; docs are standalone. The doc has full sentences, full context, full reasoning. Slides are abridged versions of the doc for live delivery.

Then: send the doc 24 hours before the meeting. Async reviewers can comment in advance. The meeting becomes a discussion, not a one-way broadcast. Decisions get made faster because the audience walked in prepared.

07Speaking the language of impact

Translation table from engineer-speak to business-speak:

  • "We optimized the algorithm" → "Page load is 40% faster, which historically correlates with 8% higher conversion"
  • "Refactored the auth service" → "Cut authentication latency by 200ms, removing the most common complaint in support tickets"
  • "Migrated to Postgres" → "Saved $40K/year in database costs and unlocked features we couldn't build before"
  • "Added test coverage" → "Reduced production incidents by 60% over the last quarter"

The pattern: every engineering accomplishment has a business translation. Find it. Lead with it. The work doesn't change; the audience's response does.

08Handling questions

Tough questions are a feature, not a bug. They mean the audience is engaged. The patterns that work:

  • Pause before answering. Two seconds of thought signals you take the question seriously and gives you time to find the best answer.
  • If you don't know, say so. "I don't know, but I'll find out and follow up by [date]" is much better than a confident wrong answer. Credibility comes from honesty.
  • Repeat the question if it's complex. "So you're asking whether X is also true for Y — yes, and here's how." Confirms you understood, gives the room context, buys you time.
  • Don't get defensive. "That's actually wrong because..." is rarely the right opening. Try "I see why you'd think that — here's what's happening..."

09Practice — and what to practice

For important presentations, practice once. Out loud. Standing up. With a timer.

You'll discover three things every time:

  • It runs longer than you expect (cut content)
  • Some transitions don't make sense out loud that made sense in your head
  • Your opening is weaker than the rest

Fix all three before the meeting. One round of practice raises presentation quality by more than any amount of slide polish.

The unfairness

There's a real injustice in the fact that engineering quality alone doesn't determine outcomes. The engineer who builds the better system but communicates it badly loses to the engineer who built the worse system but communicates it well. That feels wrong if you grew up with "the work speaks for itself."

The reality is that the work needs an advocate. If you're not advocating for it, no one will. Your audience has finite attention. Your job is to make the use of that attention pay off — for them, for your team, and for the work itself.

Better engineering presented well is unstoppable. The patterns above are the lever.