Docs Advocacy is Dev Advocacy
summary
Surveys show documentation drives adoption — 72% (Tidelift 2019) and 93% (GitHub 2017) — and lack of docs is the top reason developers reject projects (DigitalOcean 2018). The talk gives concrete, actionable moves: keep friction logs of what was tried and what failed, classify content by DITA types (task, concept, reference, troubleshooting, glossary), use templates and checklists from the Good Docs Project, donate cycles to improve tooling like Docsy, praise good docs publicly, and accept that clear writing plus small habits scales DevRel work.
AI-written summary · about
chapters (5)
- 0:00Start
- 0:24Docs advocacy is the developer-focused practice of encouraging better software documentation-whether through creating good docs yourself, helping others produce docs, or by creating a culture that enables good docs to be produced.
- 1:51Lack of documentation was the top reason developers gave for deciding against using an open source project DigitalOcean 2018
- 3:13WORK AHEAD
- 4:15NO PROBS
related talks
20mOh My Docs!
44mUseful and Beautiful Developer Docs and How to Create Them
24mWho Writes the Docs?
20mDo Docs Better: Practical Tips on Delivering...
44mCreating a Culture of Documentation
18mTechnical Documentation - How Can I Write Them Better and Why Should I Care?
21mDocs, Demos, and DevRel: The Other Side of Tech
14mDeveloper Experience: Your documentation deserves more love!