Gardening Open Docs
summary
A case study of MDN shows concrete systems and results: a homegrown Django backend called Kuma serves 10,000+ English documents with about 1,000 editors per month and ~800 active volunteers. Tooling includes automatic monitoring, a prioritization matrix, a status dashboard (area health and flags), a wiki linter, and generation of skeletons from specs. A navigation change for Spanish API pages reveals missing translations and invites contributions, demonstrating practical fixes that actually work.
AI-written summary · about
chapters (7)
- 0:00Introduction
- 1:35What is Gardening Open Docs
- 4:35Writing and maintaining a large set of documentation
- 9:16Invasiveness
- 11:06Planning
- 13:28Navigation
- 24:08Outro
related talks
46mTackling Language Barriers in Open Source Docs: A Case Study of openEuler's...
39mOpen Docs, Open Collaboration: Building Better Documentation with Community PRs
40mDocs Tools for OSS Maintainers
32mProject Economics: A case study with Open Web Docs
56mEffective Documentation: The Key to Open Source Growth
45mDocs That Scale: Strategies for Sustainable Documentation in Open Source Projects
19mThe community wrote my docs!
34mTranslating open source project documentation by many translators
