Contributing to open source projects helps you to improve your professional skills and discover new opportunities.
Being a professional software developer requires continuous improvement and learning.
It doesn’t matter if you are a boot camp or university graduate or a software development veteran, it would be useful for your own professional development (and curiosity) to explore different approaches of doing software.
Keeping up the pace is quite difficult - you have grow “horizontally" – be aware and get experience with new technologies, improve your expertise with mainstream popular tools and evolve "vertically" by solving more complex and more abstract problems.
Experienced developers are limited by the tech stack adopted by the team at their workplace. Being aware of different approaches would give them leverage and show a different perspective on the solutions that are common at the team/company and alternatives.
For the developers at the beginning of their career path, it is even more challenging. The variety of tools and techniques is overwhelming! It’s very hard to know what to focus on and what tool is best for a specific task without prior experience with similar kind of a problem.
Courses and tutorials, even advanced, usually, do not provide the required level of confidence. There’s always a "beyond the tutorial" wall. You stumble upon a problem that is out of tutorial’s scope and start looking for solutions elsewhere.
Stackoverflow Developers Survey 2019 - Most Popular Technologies.
In this post, I want to share the technique of using open source projects for professional development that I’ve been practicing during the last few years.
The JS eco-system is particularly "open sourced" - that allows using the power of OSS to the full extent.
It is very good for you
Contributing to open source is good for you. Actually, it is good for everyone, and here’s why.
You help others
No matter what your contribution type is - documentation, code changes or even just opening an issue - you improve the tools we all use and make other developers life easier.
Excellent projects quality
Open source software is not an underdog anymore. The quality of code is often superb to internal codebases. By working on projects of such a quality you see how others do good software.
Stackoverflow open source projects quality - survey 2019.
Glimpse into professional software development
You can literally see and learn how software is done at Microsoft, Google or Facebook (and many other companies are known for good engineering)- the companies share internally written code under open source license.
Collaborate with experts
It takes quite a lot of experience and expertise to recognize, implement and maintain a successful software project.
People behind these tools have a passion for their creations and love what they do - they are true experts. The feedback you’re getting while working with them is valuable.
You’re creating a proof of your expertise
Having an impressive portfolio on Github (or whatever platform of your choice) is a solid indicator for your future employer. Moreover, many headhunters use Github to find talents.
Many companies hire core contributors that work on company-supported open source projects.
I’ve accepted an offer from Facebook! Couldn’t be happier. Is this real life?
20:37 PM – 26 Aug 2016
Andrew Clark tweets about being hired by Facebook. Andrew contributed a lot to ReactJS eco-system prior to this tweet.
Some companies sponsor maintainers of open source project without hiring them.
Example of maintainers being paid for their support of BabelJS via Open Collective.
It is free
Education and experience are expensive. While engaging and contributing to open source projects, you’re getting valuable experience of practicing software development, getting feedback and creating a portfolio for free!
Stackoverflow informal education types - survey 2019.
Now that we’ve agreed that contributing is awesome, let’s try to break down the types of contribution you can do, depending on your time, required effort and expertise in the subject.
Every time you face a problem
It is hard to start contributing without any context or specific motivation - how do you pick a project that is interesting enough and would be useful for your professional development?
Stackoverflow open source contribution 2019 survey results.
It is much easier to start when you have an actual problem with a third-party open source project. A problem that matters to you.
Every time you see a problem - either it is a configuration, documentation or an actual issue, it is an opportunity to improve, contribute, and to learn/boost your professionalism!
The contribution checklist
Create an issue
That’s the minimal, least time-consuming and most important type of contribution you can do.
One can say it is not a real contribution, but I do consider it very important. In fact, Github does consider it as a contribution:
The contribution 4 types as considered by Github
Let’s start with an obvious observation - without creating an issue, maintainers would never know there’s a problem with their software, neither they would be able to improve it.
But, you’re the one who mostly benefits from doing that!
Have you ever found yourself trying to unsuccessfully solve a problem, and after a few attempts calling a colleague for help? As soon as you start to describe the problem - eureka!
You’ve suddenly got it! (Usually, it’s a typo, right?)
It is quite hard to describe a problem effectively and precisely ✍🏻. Most projects today use some kind of a template for new issues. By following the template, you’re forcing yourself to look at the problem from a different point of view.
By describing the problem in your own words, you can suddenly realize what the solution is and… just apply it!
Alternatively, describing the problem in your own words could spark new ideas/hypothesis. If that’s the case - 🙌🏻 great job- go ahead and tell your colleagues.
If not, you’ve just created an issue with a good explanation. It would help the maintainers. You helped other developer - now they are able to find the problem and realize that it is an issue with their own code. People will discover your issue and add 👍🏻
By having this first engagement you create an opportunity for the maintainers to guide you, possibly propose a solution and motivate you to open a pull request with a fix (more on that later).
See, you’re already helping lots of people!
Bonus: When creating an issue on Github, you get a nice auto-suggested list of already existing issues, that help to discover a solution and prevents duplications! 👍🏻
Github auto-suggests similar issues
Provide a minimal example
It would be much easier for the maintainers to deal with a very specific, minimal representation of the issue you’re reporting.
Although it is more time-consuming, it is also beneficial for you. By extracting the problem you get:
confirmation that it is actually a problem with the tool/library itself and not with your own code
a better understanding of what the problem is (which can be used later to effectively describe the issue)
opportunity to solve the problem by dealing with a simplified context
By removing unnecessary complexity while composing a minimal example, there’s a high chance that you understand the problem better, discover a solution or even realize that it wasn’t a problem at all 😼!
Here’s a list of some platforms that can be used to create a reproducible example:
A new repository on Github
Example of a dedicated repository with a reproducible issue.
Find a workaround
At this stage the problem is confirmed and validated, or maybe not completely validated, but… you want to move forward and just get rid of it!
Most chances you don’t have time to dig into the 3rd party library source code, but you can definitely find a workaround!
It could be an ugly monkey-patching, configuration change or some creative way you’ve found to overcome the problem. It is your obligation to share it with the world!
Either create a new issue or add a comment. You’ll get tons of ❤️ , 👍🏻 and 🎉!
Workaround and a lot of👍🏻 example
Bonus: other people could comment and share a workaround that’s better than yours.
Suggest a solution in comments
Great news - you’ve just found a solution or have great confidence about what might be a good solution!
It works great in your codebase, but you don’t have time to create a pull request with tests and /or documentation.
It still might be valuable to just share your discovery - others will pick it where you left.
BTW, often the problem is not even in the code - it might be a configuration issue or lack of clear documentation that leads projects users in a wrong direction.
The point is to share this little piece of knowledge - it is valuable, even if it doesn’t seem like significant contribution.
Implement a solution in your own repository
What happens a lot is that project maintainers are not quite responsive. Most chances they are just busy with their life, or too busy at a workplace.
A good temporary solution might be forking the project and pushing the change in your own repository.
Your peers can use your temporary repository as a dependency. While not ideal, it can help your team to move forward. ✅
Meanwhile, submit your fix as a PR. Eventually, the authors will review your fix and issue a new release. It is very important to create the PR though, otherwise, you’re at risk of being stuck with a dependency that cannot be updated.
Sometimes, authors will suggest joining core contributors list, and that’s awesome - you have the opportunity to take the responsibility and maintain a project with active users.
Create a Pull Request
Pull requests are the bread and butter of open source development.
Everyone can contribute, take part in a bigger project, leave a digital trace of skill and expertise 🌟.
Most important - it is the biggest, most effective opportunity for an individual to learn and improve 💪🏻.
Contributing to open source projects gives you superpowers and helps humanity
There’re several layers of valuable experience you gain by submitting a pull request - let’s list them:
You see how complex problems are solved, discover new architectural approaches, different ways to organize project and code
You discover new coding styles and techniques
You discover the new or different application of testing frameworks, CI pipeline, linters and enrich your experience and knowledge of using other complementary tools
You are creating an opportunity to get valuable feedback from experienced professionals
You are getting knowledge about the internal implementation of the tool you’re working on - it will help you to use it better
You’re creating an authentic, transparent record of your achievements and professionalism.
You connect with other developers, which creates opportunities for collaboration, hiring and is simply fun
That’s how you learn and become a better professional - you do more of different stuff.
You see and try different approaches, learn the good and the bad parts, apply what you’ve seen in different situations and get feedback about your decisions.
By iterating and regularly challenging yourself with more complex subjects you gain the professional confidence and experience 🥋
Discovering opportunities to contribute
As I have mentioned, it is easier to start to contribute when you have an actual issue in you have to resolve. But what should you do if you don’t work with OSS tools and still want to find contribution opportunities?
Github recommends project owners to assign labels to issues that are easier to start with. A simple search by label: good first issue will reveal more than 200k issues to pick from 😄
You use label: help wanted search query to discover more complex issues that are not necessarily beginners-friendly.
There’re plenty of resources that do some kind of aggregation based on technology, difficulty, and popularity of a project.
Here’s a list of few such projects to get you started:
Awesome list for beginners (https://github.com/MunGell/awesome-for-beginners) - a curated list of projects categorized by tech stack
http://github-help-wanted.com/ - "help wanted" issues aggregator
https://www.firsttimersonly.com/ - a list of useful reads for newcomers to open source
https://giistr.com/ - search, filter and help easily on the issues of the repositories you starred
https://www.codetriage.com/ - pick your favorite repos to receive a different open issue in your inbox every day
http://issuehub.io/ - issues aggregator by tech and difficulty labels
http://www.pullrequestroulette.com/ - a list of pull requests (or PRs) submitted for review, belonging to open-source projects
And a lot, a lot more…
There’s a good chance more people in your area are interested in open source contribution opportunities. Try to find a meetup event.
One particular example I want to highlight is Goodness Squad. I personally participated in one of those events a few years ago and it was extremely effective and helpful for me.
While writing the article and discussing it with my friends we noticed that there are plenty of resources to find projects that need contributors help. However, it is quite hard to find a project that you can learn a particular skill / coding aspect.
That’s why I have decided to try and create an alpha version of such a list:
agoldis / learn-by-contributing
A curated list of open source projects that you can learn from
Learn by contributing
It is very, very incomplete. I am trying to figure out an efficient way to discover and classify projects that others can learn by contributing. If you have any ideas, please help me!
Feel free to add your favorite project and what other can learn from it!
https://github.com/kentcdodds/babel-plugin-macros – learn how to write a babeljs plugin
https://github.com/webpack/tapable – learn a generic hooks-based architecture that powers webpack
https://github.com/ncthbrt/nact – learn about nano-services from this NodeJS implementation
https://github.com/GoogleChromeLabs/prerender-loader/blob/master/src/index.js – ???
https://github.com/tcoopman/image-webpack-loader -learn how to write a simple webpack plugin
https://github.com/willyelm/pug-html-loader – learn how to write a simple webpack loader
https://github.com/aholachek/animate-css-grid – learn how to animate complex…
View on GitHub
The Cover Photo by Hello I’m Nik on Unsplash