DEV Community

Cover image for 🦄🚀 Make Your First Github Contribution.
Ephraim Duncan
Ephraim Duncan

Posted on • Updated on

🦄🚀 Make Your First Github Contribution.

Open Source is really great and it has a lot of advantages but many people find it difficult to contribute to open source. I am writing this as a simple guide to make your first contribution on github.

First Contributions is a github repository that is focused helping beginners to make thier first open source contribution. I will guide you through the steps.

NB: You must have git installed on your computer.

Now lets start.

Fork the Repository

Alt Text

Navigate to the firstcontributions/first-contributions repository and fork it. Forking a repository is creating an exact copy of the repository in your github account up to the latest git commit message.

Clone the repository

Alt Text

Click on the green code button and copy the clone link.
On your computer with git installed, navigate to the directory you want to save the files and open your terminal in the directory.

git clone <the_link_you_copied>

# Example
git clone https://github.com/dephraiim/first-contributions.git
Enter fullscreen mode Exit fullscreen mode

Create a branch

To avoid any conflicts, create a branch to save all your changes then your branch will be merged.
First change into the directory with the command below

cd first-contributions
Enter fullscreen mode Exit fullscreen mode

Then create a branch with the checkout command

git checkout -b <your_new_branch_name>

# Example
git checkout -b add-duncan
Enter fullscreen mode Exit fullscreen mode

Make your Changes

Open the directory in your code editor. I like vim. Then make changes to the Contributors.md file.

Add your name at the end of the file with your github profile link then save the changes.

<!-- Example -->
- [Ephraim Atta-Duncan](https://github.com/dephraiim)
Enter fullscreen mode Exit fullscreen mode

Commit your changes

After you save the changes, head back to the terminal to commit your changes.
First, add the new changes to your branch with the add command

git add --all
Enter fullscreen mode Exit fullscreen mode

Then commit the change with the commit command.

git commit -m "Add <your_name> to Contributors list"

# Example
git commit -m "Add Ephraim Atta-Duncan to Contributors list"
Enter fullscreen mode Exit fullscreen mode

Push your changes to Github.

Push your changes to your remote repository using the push command.

git push origin <your_branch_name>

# Example
git push origin add-duncan
Enter fullscreen mode Exit fullscreen mode

Open Pull Request

After the git push has completed, head to your repository and you'll see this.

Alt Text

Click on the Compare button to check if your branch can merge without conflicts. If there are no merge conflicts, click on the Create Pull Request button to create a new pull request.
Alt Text

Now click on the Create Pull Request button to create a new Pull Request.

Alt Text

The repo has been linked to a bot so the pull request will be merged immediately

Alt Text

Congratulations 🎉, you just made your first contribution. The pull request will be merged very soon and you will get a notification email once the PR is merged.

Top comments (1)

Collapse
 
plooliveira profile image
Paulo Oliveira

Nice initiative!