CONTRIBUTING.md

A Guide to making your first Pull Request

Requirements

1. An account on github.com
2. git
3. A curious mind

Go ahead and get yourself an account on github.com

• If you're on windows, download git from https://git-scm.com/downloads
• If you're on Ubuntu, run sudo apt install git

Here's a great tutorial on git and github, make sure you know the basics of git before moving ahead. https://youtu.be/SWYqp7iY_Tc

Done with the video ? Cool, follow the following steps.

Fork the repository and clone it

Copy the link from your forked repository

Clone the repository

git clone <enter_your_copied_url>
cd Hacktoberfest-KIIT

To know more about cloning and forking a repository check this out!

Make a directory by your name

mkdir <your_name>
cd <your_name>

Put the programs in your directory

Note: Put your programs inside the directory of your name only. Try and keep one pull request per program you add. You can have a look at the example programs already added

Commit and Push your changes

• Inside the Hactoberfest-KIIT directory

# Do this once, only for the first time
git remote add upstream https://github.com/junaidrahim/Hacktoberfest-KIIT.git

Commit your changes

git add .
git commit -m "<Program Name> : <Program Description>"

To know more about making commits check out this link

Sync your forked repository with the original repository

To avoid merge conflicts and make clean pull requests

git pull upstream master

To know more about syncing a fork check out this awesome link by github

Push the changes to your forked repository

git push origin master

Make a pull request

click on pull request in your forked repository

then click on create pull request

Now the owner of the repository will accept your pull request and merge changes with the original repository

Now make 4 pull requests more and get ready to win those awesome hacktoberfest rewards

• To know more about making a pull request check out this link
• To know more about contributing to open source check out this awesome guide!

Resources and Tutorials

• https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source
• https://opensource.guide/
• https://dev.to/t/opensource
• https://www.digitalocean.com/community/tutorials/how-to-create-a-pull-request-on-github
• https://github.github.com/training-kit/