Get AI summaries of any video or article — Sign up free
Document What Matters: Lean Best Practice for Process Documentation - Gillian von Runte thumbnail

Document What Matters: Lean Best Practice for Process Documentation - Gillian von Runte

Write the Docs·
6 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

Treat documentation as value delivery: remove documentation for unused features or steps to avoid waste.

Briefing

Lean best practice for process documentation starts with a blunt premise: document only what creates customer value, and keep it current by making documentation part of everyday work. Continuous improvement teams often treat documentation as a burden—especially when there’s no dedicated technical writing staff, tight delivery timelines, or early-stage buy-in. The result is predictable: either documentation never gets started, or it’s produced in bulk and becomes unusable because it goes out of date.

The core fix is to apply lean thinking to documentation decisions the same way lean applies to product and process work. First, eliminate the need: if a feature, step, or service capability isn’t used or doesn’t solve a real customer problem, documenting it is waste. Instead of adding an extra layer of instructions around something customers don’t want, teams should simplify the underlying experience where possible and focus on what users actually need. That includes designing for intuitive use—when the interface or service flow is self-evident, documentation shrinks naturally—and reducing risk so users can recover when something goes wrong. Repetition also matters: tasks people perform consistently tend to require less explanation, so documentation can concentrate on the moments where errors are most likely.

Second, use “show, don’t tell” through on-the-ground instructions placed near the point of action. Visuals, diagrams, and short videos often communicate faster than text and can embed the “why” behind the rule, not just the command. The talk illustrates this with multiple real-world signage examples: a wall of text at a monkey park that people ignore versus a prioritized, visual set of key do-not-do rules; empathetic illustrations in Japan that discourage feeding pigeons by showing the impact on the animal; and diagrams in restrooms that turn compliance into something immediately understandable and even humorous. The message is that visuals reduce cognitive load and increase attention, especially when people are rushed.

Third, target value by prioritizing documentation around the interactions that matter most. Lean Six Sigma customer experience thinking pushes teams to focus on high-impact customer touchpoints and risk areas—where customers repeatedly make mistakes, where pain points recur, or where failures carry meaningful consequences. A key framework borrowed from Scandinavian Airlines’ “moments of truth” approach breaks the problem into three steps: identify the customer surface (where interaction happens), select the critical areas (not every interaction is equal), and improve those moments—often by changing how instructions are described so users avoid errors.

A detailed example comes from problematic elevator signage. Instructions told riders to “select the destination floor,” “move,” and followed confusing wording and excessive text—leading to queues, frustration, and repeated wrong actions. Reframing the signage around moments of truth produced a clearer, error-tolerant flow: use precise verbs like “enter,” provide a pathway when lifts are full (advise reception), and shorten steps so riders can act immediately rather than interpret long instructions.

Finally, documentation must become normal—or be removed. If it sits unused, it will drift out of date and lose trust. In agile environments without technical writers, the talk argues for shared ownership: everyone involved updates documents with every change, aligns internal process with what users see, and uses lightweight visual management (including “measles charts”) to track where customers struggle. The result is documentation that stays relevant, reduces errors, and supports continuous improvement instead of becoming shelfware.

Cornell Notes

Lean documentation work should be treated like value delivery: remove what isn’t needed, make what remains easy to use, and keep it current. The approach emphasizes eliminating wasteful features from the documentation scope, using “show, don’t tell” with on-the-ground visuals and videos near the point of action, and targeting the highest-value interactions first—especially risk points and recurring customer mistakes. A “moments of truth” lens helps teams identify where customers actually interact and which touchpoints deserve the clearest instructions. Finally, documentation must be “normal or not at all”: if it isn’t used daily, it will go out of date, so teams need shared ownership to update it with every change.

Why does “eliminate the need” matter more than producing more documentation?

Lean treats unnecessary documentation as waste. If a feature, step, or capability isn’t used or doesn’t solve a customer problem, documenting it adds effort without improving customer outcomes. The talk also links documentation burden to design: when interfaces are intuitive, fewer explanations are required. It recommends starting with user research (or beginning it) to understand what users actually want, then simplifying the underlying experience where possible rather than wrapping complexity in extra instructions.

What does “show, don’t tell” look like in practice for process documentation?

“On-the-ground instructions” place guidance near the feature or service so people can act immediately. Visuals—diagrams, images, and videos—often outperform text because they reduce reading time and cognitive load. Examples include signage that prioritizes a few key safety rules at a monkey park, empathetic illustrations that discourage feeding pigeons by showing the impact on the animal, and restroom instructions that use humor and clear visuals to communicate what to do (or what not to do) without relying on long text.

How do teams decide what to document first using a value lens?

Prioritization should follow customer value and risk. The talk recommends focusing on interactions with the most frequent use, the highest risk of failure, and recurring pain points where users repeatedly make the same mistakes. If something goes wrong with high impact, documentation should be strengthened there first. When data isn’t available, teams can still apply a risk lens to predict where errors are likely and target documentation accordingly.

What are “moments of truth,” and how do they change documentation decisions?

Borrowed from Scandinavian Airlines’ customer experience model, “moments of truth” shift attention from internal assets (fleet, training) to the actual interactions customers experience. The method is three steps: identify the customer surface (where interaction happens), select critical areas (not every interaction matters equally), and improve those moments—often by adjusting wording and clarity so users avoid errors. The elevator signage example shows how changing instructions and adding a recovery pathway reduced confusion and frustration.

Why is “normal or not at all” a documentation rule, not just a slogan?

Documentation that isn’t used becomes shelfware and quickly goes out of date, undermining trust. The talk frames this as a choice: either make documentation part of daily work (so it stays updated) or remove it. In organizations without technical writers, shared ownership is essential—people actively making changes in agile teams must update documents with every change. Internal and external alignment matters too, so what teams do matches what users see.

How can teams track where documentation or processes fail without heavy bureaucracy?

The talk suggests using visual management tools during continuous improvement. Documents can be marked up during stand-ups or improvement activities, and teams can record recurring issues using lightweight charts—specifically mentioning a “measles chart” (with dots or other symbols) to show where problems occur. The goal is consistent, casual tracking of where customers struggle so teams can target fixes.

Review Questions

  1. Which documentation decisions would you classify as “waste,” and what evidence would you use to justify eliminating them?
  2. How would you redesign a confusing sign or instruction using on-the-ground visuals and a moments-of-truth approach?
  3. What mechanisms would you put in place so documentation stays updated in an agile team without technical writers?

Key Points

  1. 1

    Treat documentation as value delivery: remove documentation for unused features or steps to avoid waste.

  2. 2

    Make the experience more intuitive and reduce error risk so documentation doesn’t have to compensate for poor design.

  3. 3

    Use on-the-ground instructions near the point of action, relying on visuals, diagrams, and short videos to communicate quickly and clearly.

  4. 4

    Prioritize documentation around high-value customer interactions—risk points, frequent touchpoints, and recurring user mistakes.

  5. 5

    Apply the “moments of truth” lens to identify where customers interact and which touchpoints need the clearest, most error-tolerant guidance.

  6. 6

    Adopt “normal or not at all”: if documentation isn’t used daily, it will go out of date, so either integrate it into daily work or remove it.

  7. 7

    Create shared ownership for updates in agile environments, and use visual tracking (e.g., measles charts) to spot and fix recurring failure points.

Highlights

Documentation becomes effective when it’s treated like lean work: eliminate waste, focus on value, and keep guidance current.
“Show, don’t tell” works because visuals and on-the-ground instructions reduce reading time and embed the “why,” not just the command.
The elevator example demonstrates how moments-of-truth thinking turns signage into an error-recovery pathway instead of a confusing instruction wall.
A “normal or not at all” rule prevents shelfware: unused documentation predictably drifts out of date and loses credibility.

Topics

  • Lean Documentation
  • On-the-Ground Instructions
  • Moments of Truth
  • Customer Experience
  • Visual Management

Mentioned

  • Gillian von Runte
  • Young Carlson