Read this guide in other languages
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
- Direct GitHub searches
- Mozilla's contributor ecosystem
- Useful articles for new Open Source contributors
- Using Version Control
- Open Source books
- Open Source contribution initiatives
Contributing to Open Source in general
- The Definitive Guide to Contributing to Open Source by @DoomHammerNG
- An Intro to Open Source - Tutorials by DigitalOcean to guide you on your way to contribution success here on GitHub.
- Issuehub.io - a tool for searching GitHub issues by label and language.
- Code Triage - another, really nice, tool for finding popular repositories and issues filtered by language.
- Awesome-for-beginners - a GitHub repo that amasses projects with good bugs for new contributors, and applies labels to describe them.
- 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.
- Contribute to Open Source - Learn the GitHub workflow by contributing code to a simulation project.
- Linux Foundation's Open Source Guides for the Enterprise - The Linux Foundation's guides to Open Source projects.
- CSS Tricks An Open Source Etiquette Guidebook - An Open Source Etiquette Guidebook, written by Kent C. Dodds And Sarah Drasner.
- A to Z Resources for Students - Curated list of resources and opportunities for college students to learn a new coding language.
- Pull Request Roulette - This site has a list of pull requests submitted for review belonging to Open Source projects hosted on Github.
- "How to Contribute to an Open Source Project on GitHub" by Egghead.io - A step-by-step video guide of how to start contributing to Open Source projects on GitHub.
- Contributing to Open Source: A Live Walkthrough from Beginning to End - This walkthrough of an open source contribution covers everything from picking a suitable project, working on an issue, to getting the PR merged in.
- "How to Contribute to Open Source Project by" Sarah Drasner - They are focusing on the nitty-gritty of contributing a pull request (PR) to someone else’s project on GitHub.
- "How to get started with Open Source by" Sayan Chowdhury - This article covers the resources for contributing to open source for beginners based on their favorite language interest.
- "Browse good first issues to start contributing to open source" - GitHub now helps you find good first issues to start contributing to open source.
- "How to Contribute to Open Source Project" by Maryna Z - This comprehensive article is directed towards businesses (but still useful for individual contributors) where it talks about why, how, and what open-source projects to contribute to.
- "start-here-guidelines" by Andrei - Lets Git started in the world of opensource, starting in the opensource playground. Especially designed for education and practical experience purposes.
Direct GitHub searches
Search links that point directly to suitable issues to contribute to on GitHub.
- is:issue is:open label:beginner
- is:issue is:open label:easy
- is:issue is:open label:first-timers-only
- is:issue is:open label:good-first-bug
- is:issue is:open label:"good first issue"
- is:issue is:open label:starter
- 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 a 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 choose (and contribute to) your first Open Source project by @GitHub
- 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
- How to Contribute to Open Source by @GitHub
- How to Find a Bug in Your Code by @dougbradbury
- Mastering Markdown by @GitHub
- First mission: Contributors page by @forCrowd
- How to make your first Open Source contribution in just 5 minutes by @roshanjossey
- Hacktoberfest 2019: How you can get your free shirt — even if you’re new to coding by @quincylarson
- A Bitter Guide To Open Source by @ken_wheeler
- A junior developer’s step-by-step guide to contributing to Open Source for the first time by @LetaKeane
- Learn Git and GitHub Step By Step (on Windows) by @ows-ali
- Why Open Source and How? by @james-gallagher
- How to get started with Open Source - By Sayan Chowdhury
- What open-source should I contribute to by Kent C. Dodds
Using Version Control
- Think Like (a) Git - Git introduction for "advanced beginners," but are still struggling, in order to give you a simple strategy to safely experiment with git.
- Try Git - Learn Git in 15 minutes from within your browser for free.
- Everyday Git - A useful minimum set of commands for Everyday Git.
- Oh shit, git! - how to get out of common
gitmistakes described in plain English; also see Dangit, git! for the page without swears.
- Atlassian Git Tutorials - various tutorials on using
- GitHub Git Cheat Sheet (PDF)
- freeCodeCamp's Wiki on Git Resources
- GitHub Flow (42:06) - 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.
- Git-it - Step by step Git tutorial desktop app.
- Flight Rules for Git - A guide about what to do when things go wrong.
- Git Guide for Beginners in Spanish - A complete guide of slides about git and GitHub explained in Spanish. Una guía completa de diapositivas sobre git y GitHub explicadas en Español.
- Git Kraken - Visual, cross-platform, and interactive
gitdesktop application for version control.
- Git Tips - Collection of most commonly used git tips and tricks.
- Git Best Practices - Commit Often, Perfect Later, Publish Once: Git Best Practices.
- Git Interactive Tutorial - Learn Git in the most visual and interactive way.
Open Source books
- Producing Open Source Software - Producing Open Source Software is a book about the human side of Open Source development. It describes how successful projects operate, the expectations of users and developers, and the culture of free software.
- Open Source Book Series - Learn more about Open Source and the growing Open Source movement with a comprehensive list of free eBooks from https://opensource.com.
- Software Release Practice HOWTO - This HOWTO describes good release practices for Linux and other Open-Source projects. By following these practices, you will make it as easy as possible for users to build your code and use it, and for other developers to understand your code and cooperate with you to improve it.
- Open Sources 2.0 : The Continuing Evolution (2005) - Open Sources 2.0 is a collection of insightful and thought-provoking essays from today's technology leaders that continues painting the evolutionary picture that developed in the 1999 book, Open Sources: Voices from the Revolution.
- The Architecture of Open Source Applications - Show how various aspects of Git work under the covers to enable distributed workflows, and how it differs from other version control systems (VCSs).
- Open Sources: Voices from the Open Source Revolution - Essays from open-source pioneers such as Linus Torvalds (Linux), Larry Wall (Perl), and Richard Stallman (GNU).
Open Source contribution initiatives
- Up For Grabs - Contains projects with beginner-friendly issues
- First Timers Only - A list of bugs that are labelled "first-timers-only".
- First Contributions - Make your first Open Source contribution in 5 minutes. A tool and tutorial to help beginners get started with contributions. Here is the GitHub source code for the site and opportunity to make a contribution to the repository itself.
- Hacktoberfest - A program to encourage Open Source contributions. Earn gifts like t-shirts and stickers by making at least 4 pull requests in the month of October.
- 24 Pull Requests - 24 Pull Requests is a project to promote Open Source collaboration during the month of December.
- Ovio - A platform with a curated selection of contributor-friendly projects. It has a powerful issue search tool and let's you save projects and issues for later.
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.