A treasure map for the doc – Exploring the discoverability of documentation
summary
Documentation discoverability is the problem being solved with concrete steps: claim that discovery paths cut time to useful content by linking videos blogs tutorials and existing docs; implementation uses YouTube a lesson gallery multiple blog systems forums and an internal card catalog site that assembles placeholders for reuse; automation is currently absent so paths are assembled manually; non negotiables are consistent style navigation and language; outcome is measurable reuse more exposed buried content and users actually finding and following the right path.
AI-written summary · about
chapters (9)
- 0:00Introduction
- 1:29The evolution of documentation
- 3:53Your documentation is a treasure chest
- 7:10Example leaking garden tap
- 9:05Discovery paths
- 12:01Product pages
- 14:02Takehome messages
- 17:01Automation
- 19:01Design from reuse
related talks
05mI'm Make Technical Videos... Am I Still a Documentarian?!
23m3-Step Path for Fixing Data Discoverability
31mMaking documentation discoverable in search engines
14mDeveloper Experience: Your documentation deserves more love!
44mUseful and Beautiful Developer Docs and How to Create Them
36mIf you build it, they will come: Our journey to unified (and discoverable) docs
34mProving and improving the value of your docs
22mAudience, Market, Product