Documentation Thinking Beyond the Docs: Lessons from Decision-Facing Technical Writing
summary
Documentation skills shift from explaining to justifying: clear claims, explicit comparisons, and tight structure win decisions. Concrete artifacts include concept diagrams that force an entry point and flow, discriminator tables that map features to real-world value, and annotated graphs and a short case study that show where a structural‑damage model outperforms alternatives. Multiple iterations remove non‑discriminating detail so reviewers see the differentiator quickly and can decide to fund or pilot.
AI-written summary · about
chapters (13)
- 0:00Introduction and background
- 1:03Transition to proposal writing
- 2:59Understanding the shift
- 4:48The decision-facing context
- 7:38Explanation vs. justification
- 10:27Designing for evaluation
- 12:28Diagrams for understanding
- 15:23Using discriminator tables
- 18:04Effective comparative writing
- 20:00Iterating for clarity
- 22:07Real-world case study
- 24:11Documentation thinking takeaways
- 26:48Closing and Q&A
related talks
01h 24mWriting Documentation - Practices and Theory
37mHumanising Your Documentation
26mWe're Agile, We Don't Do Documentation
18mTechnical Documentation - How Can I Write Them Better and Why Should I Care?
32mApplying Engineering Principles to Technical Writing
29mHumanizing Your Documentation
44mHumanizing Your Documentation
40mDocumentation as User Experience