hzoo/how-to-contribute-to-open-source

A guide to contributing to open source

Welcome newbie open source contributors!

This is a list of resources for people who are new to contributing to open source.

If you find additional resources, please contribute a pull request.

If you have questions or comments, please create an issue.

Contributing to open source in general

• Up For Grabs - a list of projects with beginner-friendly issues.
• Issuehub.io - a tool for searching GitHub issues by label and language.
• First Timers Only - a list of bugs that are labelled "first-timers-only".
• YourFirstPR - starter issues on GitHub that can be easily tackled by new contributors.
• Awesome-for-beginners - a GitHub repo that amasses projects with good bugs for new contributors, and applies labels to describe them.
• Openhatch - a non-profit organization that helps lower barriers of entry into open source. You can find bugs and projects here, as well.
• Open Source Guides - Collection of resources for individuals, communities, and companies who want to learn how to run and contribute to an open source project.
• 45 Github Issues Dos and Don’ts- Do's and Don'ts on GitHub.
• GitHub Guides - basic guides on how to use GitHub effectively.
• First Contributions - Make your first open source contribution in 5 minutes. A tool and tutorial to help beginners get started with contributions.

Direct GitHub searches

Search links that point directly to suitable issues to contribute to on GitHub

• is:issue is:open label:easy
• is:issue is:open label:beginner
• is:issue is:open label:up-for-grabs

Mozilla's contributor ecosystem

• Good First Bugs - bugs that developers have identified as a good introduction to the project
• Mentored Bugs - bugs that have a mentor assigned who will be there on IRC to help you when you get stuck while working on fix
• Bugs Ahoy - a site dedicated to finding bugs on Bugzilla
• Firefox DevTools - a site dedicated to bugs filed for the developer tools in the Firefox browser
• What Can I Do For Mozilla - figure out what you can work on by answering a bunch of questions about your skill set and interests
• Start Mozilla - a Twitter account that tweets about issues fit for contributors new to the Mozilla ecosystem

Useful articles for new open source contributors

• "How to find your first open source bug to fix" by @Shubheksha
• "First Timers Only" by @kentcdodds
• "Bring Kindness Back to Open Source" by @shanselman
• "Getting into Open Source for the First Time" by @mcdonnelldean
• "Contribute to Open Source in Github" by @Github
• "How to Find a Bug in Your Code" by @dougbradbury

Using version control

• Oh shit, git! - how to get out of common git mistakes described in plain English
• Atlassian Git Tutorials - various tutorials on using git
• GitHub Git Cheat Sheet (PDF)
• freeCodeCamp's Wiki on Git Resources
• GitHub Flow - GitHub talk on how to make a pull request
• GitHub Learning Resources - Git and GitHub learning resources
• Pro Git - The entire Pro Git book, written by Scott Chacon and Ben Straub and published by Apress.
• Try Git - Learn Git in your browser for free
• Git-it - Step by step Git tutorial desktop app

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.