Open Source Survival Guide

on YouTube ↗50m

" summary

Claim: documentation is the preeminent issue for open source and fixing READMEs and guides yields the biggest usability wins. Three concrete roles appear: maintainers collaborators consumers. Practical tools and tactics: add a CONTRIBUTING file, use RuboCop and automated builds, provide Docker/Vagrant dev setups, label issues for first-time contributors, run pull-request nights and pair-program (Screenhero Hangouts Skype). Examples: a user-group PR night and mentoring produce accepted docs and fewer tickets; writing long-form guides (React Redux book) proves effective.

AI-written summary · about

" chapters (7)

1. 0:00Introduction to open source
2. 4:56Dreyfus model of skills
3. 10:51The documentation challenge
4. 17:53Contribution strategies
5. 23:23Improving project onboarding
6. 30:16Community and communication
7. 34:14Managing self-deception

" related talks

• 56mEffective Documentation: The Key to Open Source GrowthBolaji Ayodeji · foss-north 2020
• 38mGuide to getting started in open sourceAbigail McCarthy · Write the Docs Portland 2021
• 35mThe Art of Documentation and Readme.md for Open Source ProjectsBen Hall · KubeCon + CloudNativeCon North America 2017
• 29mThe Technical Writers Guide to Contributing to Open Source ProjectsEdidiong Asikpo · All Things Open 2020
• 27mDesign Your Open Source ProjectBryan Veloso · PyCon Philippines 2012
• 30mHow you write matters in open sourceKyle J Davis · FOSS Backstage 2024
• 22mA beginner's guide to Open SourceDana Scheider · RubyConf Colombia 2017
• 47mPanel Discussion: A How-to Guide for Contributing to Open Source as an EmployeeDeb Nicholson, Duane O'Brien, Alyssa P Wright, Richard Littauer, Josep Prat · Open Source Summit North America 2022