First Open Source Contribution


Let's Do This!

For my first open source contribution, I chose to work on a project completed by students from the front end program a module ago. While I was familiar with the app from using it as a student at Turing, I had no idea what the codebase looked like.

The first step in making an open source contribution is to fork the repo and get it running locally on your machine. This sounds simple enough but it proved to be a challenge this time. I tried to troubleshoot this myself, but when that didn’t get me anywhere I chose the next best thing. I looked through the repo to determine whether there might be another person who was working on this to see if they had run into the same issue. An instructor at the school kept popping up so I reached out to her. She told me that she had been stumped on this for a couple of days but walked me through the steps she took to get it running. Moving on!

The next thing on the agenda was to familiarize myself with the codebase so that I could understand the app a little better. The first thing that caught my attention was the fact that this codebase had a React front-end. I’ve dabbled with React on one of my other projects but by no means am I an expert in it. It took me a little while to get a hang of how the data was flowing through the application but once I got settled in it was time to pick an issue to take care of.

The cool thing about open source projects is that developers can create issues for features that they need help with or don’t have the time to do themselves. I picked up an issue with the label help wanted that I thought I could figure out and started planning my approach to the problem.

My task was to write some regex to check whether the link provided was a valid url before saving it to the database. In this case, I had to prepend http:// to the link if the user had forgotten to do it themselves. The implementation itself was not that difficult but I had to make sure that I didn’t break anything in the process and that I adhered to the naming conventions that they had been using. I made sure to add a couple of tests to illustrate how the code is supposed to work and just like that I was ready to make my first pull request to an open source project.

Creating the pull request was the most nerve-wracking part of the entire process. It’s your first interaction with the developers working on the codebase and you have to be ready to explain your thought process and your implementation. I made sure to double check everything and then proceeded to create what I hope is the first or many pull requests open source projects.

As of today, I’m still waiting to hear back but I’ll make sure to give an update once they get back to me!