This repository targets beginners:beginner: to guide them about open source, help them make their first contribution and help them know their code.
The following text explains how to push your local changes to the remote repository and how to create a Pull Request. If you already know that, just go through the Contributing Guidelines and you are ready to contribute!
-
A github account
-
Git CLI
-
An IDE:
i. VSCode
ii. Sublime for HTML, CSS and JS
iii. Or any other IDE of your choice
-
Fork the repository
To fork the repository click on the fork button on the top right corner of the repository section. It will create a copy of that repository in your account.
-
Open Git CLI and follow these steps:
-
Clone the repository
i. Copy the URL of the repository.
ii. To copy the contents of the repository in your local
git clone <paste the copied url from github>
Then you can open the cloned repository in any IDE and make changes.
-
Switch to the branch you want to contribute to.
git checkout <your-branch-name>
-
Read the repository's contributing guide before starting any editing.
-
Make changes in the contributing branch.
-
Stage the changes
git add <your-full-file-name> (with path)
(to stage all files, usegit add .
) -
Commit the changes
git commit -m "Your message"
-
Push the changes
git push -u origin <your-branch-name>
-
Create an issue in the repository describing the changes you want to make. To know how to do that, see the Contributing Guidelines.
-
Pull request(requesting the project creator to add/merge your changes to the main repository)
i. Ensure that you make PR to the right branch.
ii. Add relevent title and description to your pull request that explains the changes you made appropriately.
iii. Click on create pull request button.
iv. Make sure to mention the issue you want to fix in the description of your pull request. (Format :
Refer to issue #<issue-number>
) -
Now you just have to wait for the project creator/owner to review your request and merge your changes to the original code. Congratulations on doing your very first contribution to an open source!:fist_right::fist_left: