Silence Is Not Approval: When Better Docs Create More Feedback
summary
Documentation for a proprietary game engine scales from 15 to 1,000 users, feedback stops being ignorable and a lightweight loop is built: annual surveys, short tracking surveys, onboarding prompts, temporary focus groups, documentation ambassadors, and Asana tasks with open comments. Tools are simple—Google Forms, Slack, Zoom, Asana—and the result is lower average ratings but far more specific complaints, higher engagement, shared ownership of docs, and visible fixes that close the feedback loop.
AI-written summary · about
chapters (21)
- 0:00Host introduction
- 0:42Speaker background
- 1:23Documentation challenges
- 3:11Feedback collection struggles
- 5:41From surveys to structure
- 7:08Documentation ambassadors
- 9:14Comprehensive feedback system
- 10:19Closing feedback loop
- 12:07Results and engagement
- 13:36Metrics and management
- 15:22Lessons learned
- 16:49Shared docs ownership
- 17:33Vocal users value
- 18:37Direct user talks
- 19:20Docs as relationship
- 20:02Q&A
- 21:06Engaging for feedback
- 22:11Handling unpleasant feedback
- 22:55Tools and methods
- 24:17Stakeholder engagement
- 25:02Closing remarks
related talks
52mFacilitating Safe and Inclusive Feedback
14mdocs docs docs
56mEffective Documentation: The Key to Open Source Growth
20mDo Docs Better: Practical Tips on Delivering...
51mTechnically speaking improve your code documentation
44mCreating a Culture of Documentation
33mWhat The Doc?!?! How to Write and Read Documentation That Allows You To Get Sh*t Done!
32mBetter: Fearless Feedback for Software Teams