Re-thinking product adoption through documentation design
summary
Argues that the fastest way to boost adoption for 17 open-source database products is redesigning the docs rather than refactoring core software, and reports concrete steps: consolidating 17 separate docs sites under a new homepage, tweaking a Material mkdocs theme for better typography, running A/B tests on top vs sidebar navigation, and adding event analytics with PostHog. Early results show clearer flows and higher usability metrics, but changes remain experimental while content inconsistencies are resolved.
AI-written summary · about
chapters (8)
- 0:00Introduction and speaker background
- 3:20Why focus on documentation for adoption
- 6:35Challenges with database documentation
- 8:02Defining documentation strategy
- 11:56UX improvements for documentation sites
- 16:10Navigation and user journey enhancements
- 18:18Results and next steps
- 19:41Q&A: Getting users to use documentation
related talks
56mEffective Documentation: The Key to Open Source Growth
14mdocs docs docs
40mDocumentation as User Experience
43mDocumentation is UX! - Change my mind
28mStop writing docs; start helping!
51mTechnically speaking improve your code documentation
14mDocs for Everyone!
29mMove Fast and Document Things: Writing internal docs at fast-moving organizations