Documentation with Human Connection
summary
Navis applies Peter Elbow’s methods to revive dense enterprise docs: an eight‑writer team with 10,000+ pages adopts free writing to force concrete connections, then boils drafts into focused overviews and elevator‑pitch summaries, and runs peer reviews like movies of the mind and summary‑and‑sayback. Storyboards for video expose vague feature overviews; a specific rewrite fixes an uncertain VGM/gross‑weight passage and shifts tone from tentative to directive. Results show writers’ voices sharpening and one veteran writer reporting deeper feature understanding.
AI-written summary · about
chapters (12)
- 0:00Start
- 5:15Writing without Teachers by Peter Elbow
- 9:14Free Writing
- 11:25Usability Issues
- 12:16The Elevator Pitch
- 15:07How Do You Know if Anything You'Ve Written and Summarized Has Hit the Mark
- 15:56Reading for Voice
- 19:53Movies of the Mind
- 21:50Quantization
- 23:29Intro to Quantum Mechanics
- 25:14Quantum Leap
- 26:15How To Implement Elbows Peer Review Techniques
related talks
34mDocumentation Thinking Beyond the Docs: Lessons from Decision-Facing Technical Writing
35mFrom Code to Clarity: Collaboration with Devels when Writing Product Documentation
29mHumanizing Your Documentation
22mUncharted waters: Documenting emerging technology
01h 24mWriting Documentation - Practices and Theory
55mThe Emperor Has No Docs
21mWriting documentations that don't suck!
48mBeyond Words: Crafting User-Friendly Documentation