denicmarko ¶

Introduction ¶

By doing open source contributions, you will learn a lot.

It allows you to become a part of the open-source community. It can be hard at the beginning, but it’s definitely worth it.

How do you make a pull request ? How to ask the maintainers to merge it ? ¶

How do you make a pull request ? How to ask the maintainers to merge it ?

Let’s start!

First of all, you should know the basics of git. You’ll need a GitHub account as well. If you don’t have one, you can create it here.

Step 1: Find a project you want to contribute to. ¶

If you want to practice a little bit first, you can use this demo repository. Don’t worry, I created it for this purpose.

Step 2: Fork the repository ¶

Once you’re there, click the “Fork” button. This will copy the whole project under your GitHub user. The link will look like this https://github.com /<YourUsername>/git-demo.

Step 3: Clone the repository ¶

Open your terminal, and run the following command:

            git clone https://github.com/<YourUsername>/git-demo.git

           

This will create a local copy of the repository.

Step 4: Create a new remote for the upstream repository ¶

For this we will use the following command:

            git remote add upstream https://github.com/markodenic/git-demo

           

Step 5: Create a new branch ¶

We can do this by running the command:

            git checkout -b my-branch

           

This will create a new branch, and switch to it.

Step 6: Add some code ¶

Now, the time has come, we actually add some code. 😊 After adding the changes, you can check them by running git status.

If everything is as expected, we can add the code to the staging area:

            git add .

           

Step 7: Commit your changes ¶

This is the last step before pushing the code to the repository. Run the command:

            git commit -m "Adding an awesome feature to my-branch"

           

Step 8: Push the changes to your repository ¶

Finally, we’re ready to push the changes. git push is the command we need in this case. Let’s run it:

            git push -u origin my-branch

           

Step 9: Create a pull request ¶

Once we pushed the changes to our repository, we are ready to open the pull request. Go back to your repository and click on the “Compare and Pull Request” button.

If everything went OK, the maintainer of the repository will merge your pull request. Congratulations, you made your first open-source contribution! Quick recap:

Find a project you want to contribute to.
Fork the repo.
Clone the repository.
Create a new remote for the upstream repository.
Create a new branch.
Add your changes.
Commit your changes.
Push the changes to your repository.
Create a pull request.