#
Hacktoberfest is a month-long celebration of open source software run by DigitalOcean in partnership with GitHub and Twilio. Hacktoberfest is open to everyone in our global community!
You just need to make four contributions to open source before October 31 and can receive a free Hacktoberfest t-shirt.
This project aims to simplify and guide the way beginners make their first contribution. If you are looking to make your first contribution, follow the steps below.
If you don't have git on your machine, install it.
Fork this repository by clicking on the fork button on the top of this page. This will create a copy of this repository in your account.
Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the code button and then click the copy to clipboard icon.
Open a terminal and run the following git command:
git clone "url you just copied"
where "url you just copied" (without the quotation marks) is the url to this repository (your fork of this project). See the previous steps to obtain the url.
For example:
git clone https://github.com/<your-username>/Hacktoberfest_2022.git
where this-is-you
is your GitHub username. Here you're copying the contents of the first-contributions repository on GitHub to your computer.
Change to the repository directory on your computer (if you are not already there):
cd Hacktoberfest_2022
Now create a branch using the git checkout
command:
git checkout -b <your-new-branch-name>
For example:
git checkout -b add-alonzo-church
Add a reference(remote) to the original repository.
git remote add upstream https://github.com/Anisha7860/Hacktoberfest_2022.git
Check the remotes for this repository.
git remote -v
Always take a pull from the upstream repository to your master branch to keep it at par with the main project(updated repository).
git pull upstream main
Perfom your desired changes to the code base.
- create a folder and add all code in that folder only.
- create a demo folder inside "Your Project" and add a gif of your project named demo.gif (OPtional)
Now open Contributers.md
file in a text editor, add your name to it. Don't add it at the beginning or end of the file. Put it anywhere in between. Now, save the file.
If you go to the project directory and execute the command git status
, you'll see there are changes.
Add those changes to the branch you just created using the git add
command:
git add Contributers.md
Now commit those changes using the git commit
command:
git commit -m "Add <your-name> to Contributers list"
replacing <your-name>
with your name.
NOTE : In case terminal shows Author identity unknown
, use
git config user.email "your email" (including quotation marks)
git config user.name "your name" (including quotation marks)
Push your changes using the command git push
:
git push origin -u <add-your-branch-name>
replacing <add-your-branch-name>
with the name of the branch you created earlier.
If you go to your repository on GitHub, you'll see a Compare & pull request
button. Click on that button.
Add appropriate title and description to your pull request explaining your changes and efforts done.
Click on Create Pull Request
.
Woohoo! You have made a PR to the Hacktoberfest_2022 :boom: . Wait for your submission to be accepted and your PR to be merged.
Thank you for your interest in contributing to our Repo!πΌ
Soon I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged.
Congrats! You just completed the standard fork -> clone -> edit -> pull request workflow that you'll encounter often as a contributor!
Kudos to youπ
Best of luck ππ
Celebrate your contribution and share it with your friends and followers.