Interview Prep · Topic 8 of 10

Technical Communication

100 XP

Why technical communication is a career multiplier

Engineering impact is not only what you build, but how clearly others can reason about it.

Poor communication causes:

  • wrong implementations
  • delayed decisions
  • repeated debates
  • avoidable incidents

Strong communication increases leverage:

  • faster alignment
  • better design quality
  • smoother execution
  • stronger leadership signal

Four communication surfaces every engineer must master

  1. Real-time verbal (interviews, standups, design reviews)
  2. Asynchronous written (docs, RFCs, PRs, postmortems)
  3. Cross-functional updates (product/design/ops stakeholders)
  4. Conflict conversations (disagreement without politics)

Most career stalls happen because one of these surfaces is weak.


Core principles

1) Lead with outcome

Start with:

  • decision required
  • recommendation
  • reason in one line

2) Separate facts, assumptions, and opinions

Explicitly label each. This reduces unproductive argument.

3) Prefer concrete over abstract

"p99 latency increased from 180ms to 420ms after deploy" is stronger than "performance degraded."

4) Keep a clear structure

If audience cannot restate your point in 20 seconds, message is unclear.


Interview narration framework (while coding)

Use this loop:

  1. clarify requirements
  2. propose approach
  3. state invariant
  4. code with brief narration
  5. validate with test cases

Sample language:

"I’ll optimize from O(n^2) to O(n) with a hashmap. Invariant: map stores all prior elements; current complement lookup resolves pair existence."

This demonstrates reasoning, not just implementation.


Design doc template (high-signal)

Sections

  1. Context/problem
  2. Goals and non-goals
  3. Constraints
  4. Options considered
  5. Proposed design
  6. Trade-offs
  7. Rollout and rollback
  8. Metrics/observability
  9. Risks and mitigations

Option table pattern

| Option | Pros | Cons | Decision | |---|---|---|---| | A | simple | scale risk | reject | | B | scalable | operational cost | choose |

Good docs make disagreement productive.


Writing for different audiences

Engineers

  • include mechanisms
  • include complexity/failure modes
  • include migration details

Product managers

  • user impact
  • timeline and risk
  • trade-offs in delivery terms

Executives

  • business impact
  • risk exposure
  • decision and confidence level

One message does not fit all audiences.


Status update format that prevents confusion

Use:

  1. Done
  2. Next
  3. Risks/Blockers
  4. Asks

Example:

  • Done: API pagination implemented and load-tested.
  • Next: client integration and canary rollout.
  • Risk: cache invalidation edge case under retry storm.
  • Ask: 1 day from SRE for load-test environment.

Clear updates reduce management overhead and trust gaps.


Technical disagreement framework

When disagreeing:

  1. restate other view fairly
  2. present constraints and evidence
  3. propose test/experiment when uncertain
  4. align on decision owner and deadline

Avoid:

  • "this is bad"
  • authority-based arguments without evidence

Use:

"Given p99 target and failure budget, option B seems safer. If we’re uncertain, we can run a one-week experiment with success criteria."


PR communication standards

A strong PR description should answer:

  • what problem is solved
  • why this approach
  • key trade-offs
  • test plan
  • rollback plan (if risky)

Review comments should target:

  • correctness
  • reliability
  • maintainability

Avoid comments that are only stylistic unless style blocks clarity.


Incident communication

During incidents, communication is part of incident response.

Use:

  1. Impact
  2. Scope
  3. Current hypothesis
  4. Mitigation in progress
  5. Next update time

Never wait for perfect certainty to communicate impact.


Common communication anti-patterns

  1. burying decision at end
  2. overloading updates with low-signal detail
  3. mixing speculation with confirmed facts
  4. "we" language that hides ownership
  5. avoiding explicit trade-offs to "keep everyone happy"

These patterns reduce trust over time.


Practice drills

Drill 1: 60-second architecture explain

Explain any service architecture in:

  • 15s context
  • 30s core flow
  • 15s bottleneck/risk

Drill 2: design doc compression

Turn a 2-page draft into 8 bullets without losing key decisions.

Drill 3: disagreement role-play

Defend your design while fairly representing opposing view.

Communication is trainable with deliberate reps.


Evaluation rubric

Score 1-5 in:

  • clarity
  • structure
  • evidence quality
  • audience alignment
  • decision orientation

If score is below 3 in any dimension, revise before sending.


Final takeaway

Technical communication is applied systems thinking:

  • clear problem framing
  • explicit assumptions
  • evidence-backed decisions
  • concise audience-aware delivery

Master this and your technical output compounds because the whole team executes better around your work.