Measuring Documentation Success in Open Source
summary
Google’s Season of Docs 2021 changes include treating orgs as partners, funding projects with $5–15k grants, and asking orgs to pick metrics; program report shows 30 projects completed and that setting a target for new docs is easiest while increased pageviews is only half achieved and more pull requests is rare. Common failures are onboarding, payment logistics, and writer dropouts; effective tools and practices noted: Confluence, GitHub, Jira, UAT for runbooks, and clear scope reduction.
AI-written summary · about
chapters (9)
- 0:00Start
- 0:27What we'll review today
- 2:502021 Program changes
- 3:45Benefits
- 4:44Top metrics
- 6:52Top doctypes
- 8:42Top recruitment, hiring, and work issues
- 10:34Suggested strategies for TWS
- 12:212021 Program Report
related talks
56mEffective Documentation: The Key to Open Source Growth
05mKeynote: Calling All Doc Stars
33mOSS Documentation Workshop
29mThe Technical Writers Guide to Contributing to Open Source Projects
45mDocs That Scale: Strategies for Sustainable Documentation in Open Source Projects
40mDocs Tools for OSS Maintainers
05mMy Open Source Docs Addiction
27mDesign Your Open Source Project