OSS Documentation Workshop

on YouTube ↗33m

" summary

Workshop presents concrete tools and processes drawn from Google Season of Docs with 130 projects and 200 case studies condensed into resources at github.com/google/opendocs. It introduces the Docs Adviser workflow to pick a path (planless iteration, mini or heroic overhaul), the Docs Archetypes cookbook (migration archetype, tasks, deliverables, failure risks), and practical onboarding steps for technical writers (first task: update setup docs, binary tree introductions). Metrics advice: pick measures that change behavior.

AI-written summary · about

" chapters (9)

1. 0:00Welcome to docs tools
2. 3:08Understanding the 'I need docs' impulse
3. 7:42Introducing Docs Adviser
4. 14:30User needs and goals
5. 16:56Docs project archetypes
6. 21:27Avoiding Abilene paradox
7. 24:39Onboarding writers
8. 28:10Measuring doc success
9. 30:41Docs improvement resources

" related talks

• 40mDocs Tools for OSS MaintainersErin McKean · Open Source Summit Japan + AI_dev: Open Source GenAI & ML Summit + Automotive Linux Summit 2025
• 29mMeasuring Documentation Success in Open SourceErin McKean, Kassandra Dhillon · Write the Docs Portland 2022
• 05mKeynote: Calling All Doc StarsMegan Byrd-Sanicki · Open Source Summit + Embedded Linux Conference North America 2019
• 35mLearning by Example: Highlights from Google Season of DocsErin McKean · TechDocsCon @ Open Source Summit Europe 2024
• 45mDocs or it didn't happen!Mikey Ariel · foss-north 2019
• 56mEffective Documentation: The Key to Open Source GrowthBolaji Ayodeji · foss-north 2020
• 45mDocs That Scale: Strategies for Sustainable Documentation in Open Source ProjectsZainab Daodu · Open Source Summit North America 2025
• 37mTaking a step back: Analysing your documentationLana Brindley · linux.conf.au 2021