DEV Community

Cover image for Contributing to Tech Communities: How Open-Source can land you a job and get you out of the Skill Paradox 💼
Lucas Lima do Nascimento for Wasp

Posted on • Updated on • Originally published at wasp-lang.dev

Contributing to Tech Communities: How Open-Source can land you a job and get you out of the Skill Paradox 💼

Hello there!

TL;DR

How to Open-Source
In this article, we’re going to see how open-source can change your career for the better and get you out of the Skill Paradox — a point in which the skills you need to land a job are generally acquired after you get a job.

Besides that, we’ll check how you can start contributing to different open-source projects and get on the hype train of Hacktoberfest while also learning some important topics on handling feedbacks and showcasing your contributions.

1. Introduction

Are you a beginner developer that lacks certain skills needed to land a job? But you feel that you could only gain those skills on the job itself?
If you answered “yes”, then you’re stuck in situation that I would call as the “skill paradox where you need skills to get a job, but those skills are the ones you would get if you had a job. It can generate a lot of stress and frustration when you start to realize that some skills cannot be obtained while working only on side hustles and therefore, you cannot learn only by yourself, but they’re generally required for job positions.

Collaboration and teamwork, learning how to code review (giving and receiving feedback), and getting started with bigger and existing codebases are things that cannot be taught while you work on some little projects. While, of course, you can learn those skills while getting a job in tech, sometimes those skills are necessary for you to get a job, making you stay in some kind of limbo where you need some skills to get a job, and those skills are precisely the ones you would get after the job.

In those cases, there’s still a way out of the limbo: you can contribute to open-source communities. Besides the value you are generating for the whole ecosystem, this can be an amazing selling point for your career and, since Hacktoberfest is already around the corner, will be a great way to win a t-shirt or plant a tree too!

Now, let’s begin by teaching you how to actually do this.

2. First steps on Open-Source Contribution

Before we Begin

https://media.giphy.com/media/WsNbxuFkLi3IuGI9NU/giphy.gif

Throughout this article, I’m going to use as an example the Wasp Framework, since it gathers all the characteristics necessary for a good open-source repository (and it’s actually a really awesome project that you can give a star to easily by clicking on the button below 😀).

Currently, I’m part of Wasp’s team and it would mean a lot if you could check our repo (for contributions or just for testing the product out). We’re doing a real hard job on there, and, talking only as a developer, it’s really good to see some new stuff coming around in the JS ecosystem.

⭐️ Give Wasp Framework a Star! ⭐️

2.1. Finding a project

First of all, we need to choose a project. If you’re a beginner, you’re probably looking for projects that have a few characteristics:

  • It’s actively maintained.
  • Has an open-source license that we can modify and use freely.
  • It’s not insanely big (since these projects can have some really hard things to accomplish before submitting something).
  • It must have good documentation on how to contribute.
  • It must have well-characterized issues in order for you to search for something (in the case that you haven’t found the problem itself).

If you have matches in all of these points (or at least three of them), you’re good to go!

So, let me show you how to find all these characteristics:

  • It’s actively maintained and the owners of the repo reply and care for the issues!
    • In the case of Wasp’s repo, the last commit was 13 hours ago, so, there’s definitely signs of life here!

Last commit

  • It’s not insanely big → Comparing an exaggerated example with the Linux repo (if you check it, you’ll see that all pull requests there usually take a lot of time to be merged since the project is so big)

Linux repo

  • It’s good to have a documentation on how to contribute
    • Searching for the docs, I found a file called CONTRIBUTING.md (which is a common name standard for contribution guidelines) and when we open it up:

Contributing guidelines

We have a whole documentation on how to start with things! Awesome!

  • It’s good to have well characterized issues in order for you to search for something

Issues

Searching for the issues, we can easily see that they’re all labeled and that will help us A TON!

2.2. Searching for Issues

Great! Now that we have already chosen where we are going to contribute, let’s dive into the issues and search for something we want to do!

When searching for issues, the labels do us a great favor by already explicitly identifying all issues that can be good for newcomers! If you’re a beginner, good first issues and documentation are excellent labels for you to search for!

Good labels to search for

Issues on the repo labeled

Opening the first issue, we can see that someone already manifested interest on it! So, since someone has already manifested interest in that one, let’s search for another one!

The first issue

Finding another issue — it doesn’t look like anyone is working on the one below, so we can take it ourselves!

Finding another issue

By the way, it's of absolute importance that, when you find an issue, you comment and set yourself as assignee in order to let other people know that you're going to take the task at hand!

Communicating

In this case, GitHub is a great platform for us to discuss, but sometimes authors can be hard to find. In these cases, search for a link or a way to contact them directly (in the case of Wasp, they have a Discord server, for example). Communicating your way through is really important to get things sorted out, and if you’re unsure of how to communicate well with people, you can read this other article here and start to get the hang of it!

3. Guidelines for Contributing to Open-Source Projects

3.1. Reading the guidelines and writing some code

Now that we have selected a repo, an issue to work on and communicated with the authors, it’s time to check the guidelines for making Pull Requests (if you don’t know what this means, it’s basically a request to merge your modifications to the codebase, you can check some more basic git terms here too). Sometimes, these guidelines are WAY too hard and sometimes they don’t even exist (that’s an awesome first issue actually), anyways look it up and see if you find something!

You can check Wasp’s contributing guidelines here if you want to read it yourself! After reading it, it’s time to code the solution and get along with it.

Since the intent of this article is not to actually show the solving per se, I’ll skip this part and keep talking about the process itself.

3.2 Handling Code Reviews and Feedback

It’s not rare that when we code things up (especially in open-source projects), there will be some problems. Code reviews and feedback are an amazing way for us to get the bigger picture and improve our code quality, so let’s check on how to properly read and answer code reviews and feedback.

We’re generally used to receiving criticism in a harsh way, so, when someone approaches you with feedbacks, we generally move into our defense zone. Unfortunately, these cases can teach you the wrong things as it’s generally a good way to think of feedbacks as gifts! Someone spent some time writing (or speaking) things in order for you get even better on what you’re trying to accomplish.

This does not mean that all feedback is well-made or that people will always provide great feedback. Sometimes, people can be harsh. However, as you receive more and more feedbacks, you will develop a sense of which feedbacks are genuinely meant to help you improve and which are simply baseless criticism. It is crucial to be open to receiving constructive feedbacks and not take them personally.

Let’s see an example of code review and feedback here:

Code Review Example

This is great feedback! It expresses the author’s opinion without being harsh and also suggests what to make in order to be perfect! The best way to answer this is simply:

  • Thanking for the feedback
  • Saying your opinion (agree or disagree) when it makes sense
  • Work on it!

Showcasing Contributions

After all that work, it’s time for us to showcase our contributions! Document it all. GitHub (or other git platforms), personal portfolio sites, LinkedIn, and other means of reaching people have become as important as resumes nowadays, so it’s really nice to have some statistics and data to display on:

  • What open-source projects have you worked on? Try to think of this as writing a story. First, start by giving the initial context of the project and how it’s revelatory.
  • How you contributed: Then, give the context of what you made, documentation, code, and problems you solved in general. Don’t forget to not focus a lot on the technical side since the person who could be reading this may not be technical.
  • How big was the impact? Talk about how this affected the ecosystem; it can be as big or as small as you like. Never neglect the impact that changing documentation can have (remember that for us, programmers, the documentation is our source of truth, and fixes there are greatly appreciated).

Don’t forget to utilize the opportunity to engage with other developers and communities, make it so in order to get new connections and even greater opportunities later on!

Now that the theory is set, let’s check a few examples on how I would showcase a few of my contributions:

Case 1 - A big contribution

One of the ways to describe a big contribution is like this:

I made a few big contributions to a project called Coolify, which was an open-source Heroku alternative. I refactored a lot of the UI, making it cleaner and more consistent throughout the application. Currently, more than 9000 instances are installed, and the UI affects all of them! You can check out the contributions here.

Of course, you can make this text as long or as short as you want, entering more detail about how this contribution was made and what exactly you did, but for this article, this is enough for you to get a general idea.

Case 2- A small contribution

One way to describe a small contribution is like this:

I made a small change to the new documentation for Sequelize! I was just scrolling through the documentation and found this mistake that could lead others to weird debugging sessions, so as soon as I found it, I submitted a PR for them! You can check out the contribution here!

Conclusion

Just in case you haven’t starred Wasp’s repository, I would recommend doing so! It’s a great repository for anyone to contribute to, and it’s a nice framework for full-stack development!

⭐️ Give it a star! ⭐️

So, a lot was said, let’s make a quick recap on how to do contributions and how to showcase them:

  • First of all, find a repo! If you don’t have any in mind, there loads of lists (like this one) that recommend some repos for you to take a look
  • Search for an issue that is not being made and you can work on it, if you’re beginner, check for documentation and good first issue labels
  • Comment and communicate that you’re going to fix the issue - take the opportunity to talk and get to know other developers
  • Code, get you PR reviewed and ready to merge after the feedbacks
  • Merge and showcase your contributions, showing that they are your way out of the Skill Paradox

How to Open-Source

The above steps can give you a really powerful experience in software engineering (which usually happens only when you’re already hired by a company). This is an awesome way to get some recognition while improving the open-source community — giving back to other developers and getting yourself out of the Skill Paradox!

And you? Have you contributed to open-source? Let me know in the comments below, and let’s share some experiences!

Top comments (26)

Collapse
 
infomiho profile image
Mihovil Ilakovac

I think docs contributions are often looked down on, but they mean a ton.

Hack for first time contribution:

  1. Fork a project
  2. Install the Grammarly extension in VS Code
  3. Go through the docs markdown - you'll find some typos or missing articles
  4. Make the maintainers of that project happy 😊

This is a thing that makes everyone's docs more high quality, but usually it's overlooked.

Collapse
 
jimmylipham profile image
Jimmy Lipham

I can definitely see how docs contributions could be looked down upon in our circles. However to our organization, and many others, developers that write great documentation are worth their weight in gold. One of the highest costs we have is the slow ramp of developers into our ecosystem.

Personally, I see it as a sign of maturity.

Love this hack!

Collapse
 
matijasos profile image
Matija Sosic

100% percent :)

Collapse
 
vincanger profile image
vincanger

oh this is a great idea :)

Collapse
 
janmpeterka profile image
Jan Peterka

heh, now I want to write automation for this. project for this weekend? 😅

Collapse
 
llxd profile image
Lucas Lima do Nascimento

This is an amazing tip actually, typos are easy to fix and really bad for documentations. Perfect for the first issue since you generally have to read the docs to do it hahaha

Collapse
 
angelotheman profile image
Angel Oduro-Temeng Twumasi

I think I love this. How do I get started with this kind of contributing to open source

Collapse
 
anni profile image
Anietie Brownson

Great hack 😀

Collapse
 
matijasos profile image
Matija Sosic

An amazing write-up, Lucas! I especially like that you selected Wasp as an example for OSS contributions :).

My 2c - even if you find an issue that sounds interesting to you and somebody else has already expressed interest in solving it, IMHO it's often still worth it to ask what the status is and that you would be interested as well. Oftentimes the original assignee didn't have enough time to start/finish, or he could use some help!

It's a great way to start the discussions and meet people along the way - that's often how the best contributions and features are made :).

Collapse
 
llxd profile image
Lucas Lima do Nascimento

100% agreed, Matija! It's a win-win situation where you meet new people and potentially make some even greater contributions!

Thanks for the comment!

Collapse
 
nevodavid profile image
Nevo David

I have seen it many times!
Contribute a valuable contribution to open-source, and wait for companies to offer you a job!

Collapse
 
martinsos profile image
Martin Šošić • Edited

The most common point of failure for new contributors that I noticed is taking a too big bite -> they jump on a feature that is harder than they predicted, give it a try a bit, spend some energy on it and give up. While this is sometimes unavoidable, there are two things that we can do about that:

  1. As a project maintainer, we can describe, in each "good first issue" issue, what skills it requires to be solved, give some initial idea of what the solution could look like, basically any info that will paint the picture of what is required to solve this issue.
  2. As a potential contributor, we can communicate our skill level and ask for more information. So if you find an issue that you like, but are not sure if you can handle it, you can communicate about your relevant skill levels and ask for more information about it. Then the maintainer can tell you if this issue will be a good fit for you or not, and might even point you to a more suitable issue. One good way to approach this is also to join the community behind the project, if there is one, and communicate their about your skills and ask for recommended issues!
Collapse
 
okkattiboy profile image
nullbrainshadow

detailed explanation.. and it's true in my case.
I am maintaining the forked version of Django JET (original maintainers archived it). then I updated jQuery and jQuery Ui library and synced with every django upgrade.
i am getting calls from companies whoever see my profile on LinkedIn.

Collapse
 
llxd profile image
Lucas Lima do Nascimento

Wow! That's so good to hear! Keep it up with the good work and thanks for sharing your experience on this!

Collapse
 
alenhorvat profile image
Alen Horvat

But how do we get acknowledgement and recognition for our skills and contributions? What if it was as easy as editing the CHANGELOG.md? Namely, repository owners could add a machine-readable file (e.g., yaml, json) to denote the different contributions of direct or indirect contributors. WDYT?

Collapse
 
llxd profile image
Lucas Lima do Nascimento

That's a great idea! For smaller repos I think that's perfect actually, now, for larger repos with thousands of contributors I think it can be a little impratical though.

A similar way to showcase that could be approached from the POV of a repository owner is to reference the people that helped in the release tag too!

Here's an example.

I'll edit the post to add this info because I think it's super relevant! Thanks for the comment @alenhorvat!

Collapse
 
alenhorvat profile image
Alen Horvat

By reading your post and doing some research I also found github.com/all-contributors/all-co...

We're also discussing with skills recognition/HR communities about adding skills acknowledgements: github.com/skillJot/git-recognise

git and git platforms represent a new opportunity to acknowledge skills and contributions in a transparent and verifiable manner. Does any of this make sense? :)

Collapse
 
vincanger profile image
vincanger

Nice article! It's great to see that people are realizing that open-source has so many benefits, including helping you level up your skills and land you sweet jobs :)

Collapse
 
zvone187 profile image
zvone187

Being proactive in general will lead to success. Especially contributing, you're showcasing your skill, and more importantly, determination.

Collapse
 
llxd profile image
Lucas Lima do Nascimento

Determination is totally the keyword here! Thanks for the comment!

Collapse
 
anni profile image
Anietie Brownson

I love this article
I used to think making contributions to open source had to be code only
Thanks for the tips

Collapse
 
jurajmalenica profile image
Juraj Malenica

Nice stuff!

Collapse
 
hassankhosseini profile image
Hassan Khajeh-Hosseini

I can relate!

Collapse
 
boby900 profile image
Boby Tiwari

Great article 💯

Collapse
 
hsimah profile image
hsimah

This PR landed me on the desk of a Facebook recruiter. Nearly five years on I'm over in the US, still working here. Contributions count!

Collapse
 
llxd profile image
Lucas Lima do Nascimento

That is so awesome to hear! Awesome comment @hsimah!