All together now: Turning technologists into documentarians
summary
Three people start with a half‑hazard set of docs and in 18 months turn it into a serviceable platform website that consolidates scattered content under Confluence Cloud + Scroll Viewport, publishes 300+ documents, and supports 100+ engineers across 10+ teams. The team treats content like a product, adds a linter, templates, an intake process, embedded writers, and analytics/feedback loops. Results: faster publishing with editorial guardrails, a growing writing team (3→6), and an ongoing plan to move from “all right” to good.
AI-written summary · about
chapters (8)
- 0:00Intro
- 1:34Agenda
- 7:39How we did it
- 10:15Make it serviceable
- 13:05Tell customers
- 15:08S serviceable content ecosystem
- 22:50Questions
- 28:10Resources
related talks
27mA content manager's guide to crowdsourcing the docs
36mIf you build it, they will come: Our journey to unified (and discoverable) docs
30mBuilding technical documentation as a product at scale
44mPushing documentation (so it doesn't hurt anymore)
40mFrom resistance to adoption: navigating the challenges of docs-like-code
27mThe hidden power of information assets The role of documentation in product success
41mAlmost None to Some: Driving DISQO's Doc Culture as a Solo Documentarian
45mUseful and Beautiful Developer Docs and How to Create Them