This repository aims to help code beginners with their first successful pull request and open source contribution. ๐ฅณ โญ Feel free to use this project to make your first contribution to an open-source project on GitHub. Practice making your first pull request to a public repository before doing the real thing!
โญ Make sure to grab some cool swags during Hacktoberfest by getting involved in the open-source community.
This repository is open to all members of the GitHub community. Any member can contribute to this project! ๐ What is Hacktoberfest? ๐ค A month-long celebration from October 1st to October 31st presented by Digital Ocean and DEV Community collaborated with GitHub to get people involved in Open Source. Create your very first pull request to any public repository on GitHub and contribute to the open-source developer community.
https://hacktoberfest.digitalocean.com/
Rules ๐ฅ To qualify for the official limited edition Hacktoberfest shirt, you must register here and make four Pull Requests (PRs) between October 1-31, 2022 (in any time zone). PRs can be made to any public repository on GitHub, not only the ones with issues labeled Hacktoberfest. This year, the first 40,000 participants who complete the challenge will earn a T-shirt.
Steps to follow ๐ Tip : Complete this process in GitHub (in your browser)
-
Star The Repository ๐ Star the repository by pressing the topmost-right button to start your wonderful journey.
-
Fork it ๐ด You can get your own fork/copy of HacktoberFest-2022 by using the Fork button.
-
Clone it ๐ฅ NOTE: commands are to be executed on Linux, Mac, and Windows(using Powershell)
You need to clone or (download) it to local machine using
$ git clone https://github.com/Your_Username/Hacktoberfest-2022.git This makes a local copy of the repository in your machine.
Once you have cloned the Hacktoberfest-2022 repository in Github, move to that folder first using change directory command on Linux, Mac, and Windows(PowerShell to be used).
$ cd Hacktoberfest-2022 Move to this folder for all other commands.
- Set it up โฌ๏ธ
Run the following commands to see that your local copy has a reference to your forked remote repository in Github
$ git remote -v origin https://github.com/Your_Username/Hacktoberfest-2022.git (fetch) origin https://github.com/Your_Username/Hacktoberfest-2022.git (push) Now, let's add a reference to the original Hacktoberfest-2022 repository using
$ git remote add upstream https://github.com/kishanrajput23/Hacktoberfest-2022.git This adds a new remote named upstream.
See the changes using
$ git remote -v origin https://github.com/Your_Username/Hacktoberfest-2022.git (fetch) origin https://github.com/Your_Username/Hacktoberfest-2022.git (push) upstream https://github.com/Remote_Username/Hacktoberfest-2022.git (fetch) upstream https://github.com/Remote_Username/Hacktoberfest-2022.git (push) In your case, you will see
$ git remote -V origin https://github.com/Your_Username/Hacktoberfest-2022.git (fetch) origin https://github.com/Your_Username/Hacktoberfest-2022.git (push) upstream https://github.com/kishanrajput23/Hacktoberfest-2022.git (fetch) upstream https://github.com/kishanrajput23/Hacktoberfest-2022.git (push) 4. Sync it โป๏ธ Always keep your local copy of the repository updated with the original repository. Before making any changes and/or in an appropriate interval, run the following commands carefully to update your local repository.
$ git fetch --all --prune
$ git checkout main
$ git reset --hard upstream/main
$ git push origin main 5. Ready Steady Go... ๐ข ๐ Once you have completed these steps, you are ready to start contributing by checking our Good First Issue Issues and creating pull requests.
- Create a new branch
โผ๏ธ Whenever you are going to contribute. Please create a separate branch using command and keep your main branch clean (i.e. synced with remote branch).
$ git checkout -b BranchName Create a separate branch for contribution and try to use the same name of the branch as of folder.
To switch to the desired branch
$ git checkout BranchName To add the changes to the branch. Use
$ git add . Type in a message relevant for the code reviewer using
$ git commit -m 'relevant message' Now, Push your awesome work to your remote repository using
$ git push -u origin BranchName Finally, go to your repository in the browser and click on compare and pull requests. Then add a title and description to your pull request that explains your precious effort.