A beautiful arrangement: Gaining experience & giving back through open source docs
summary
Concrete steps to start: learn command line, VS Code, Git, GitHub and Markdown; do reconnaissance on repos (read CONTRIBUTING, subscribe to issues, join Slack/Discord) and test docs by running local builds and CI. Start with typo fixes, open a PR, follow GitHub PR workflow and pass CI checks, then level up with MermaidJS diagrams or localization. Contributions build a portfolio, a network, and can lead to jobs — OpenTelemetry and small projects (like a tennis-reservation repo) are cited examples.
AI-written summary · about
chapters (13)
- 0:00Introduction
- 1:27Why contribute to docs
- 2:52What is open source
- 4:44Skills needed for open source documentation
- 6:55Picking the right project
- 10:50Reconnaissance before contributing
- 15:07Early ways to give back
- 16:11Good first issue
- 20:29Common pitfalls and fixes
- 23:02GitHub etiquette
- 27:44From beginner to long-term
- 29:50Recap and benefits
- 31:41Q&A
