Skip to content

Latest commit

 

History

History
135 lines (82 loc) · 5.75 KB

hacktoberfest-guide.md

File metadata and controls

135 lines (82 loc) · 5.75 KB
Raw

How to begin with hacktober fest 2021

Hacktoberfest encourages participation in the open source community, which grows bigger every year. Complete the 2021 challenge and earn a limited edition T-shirt.

Hacktoberfest, in its 8th year, is a month-long celebration of open source software run by DigitalOcean. During the month of October, we invite you to join open-source software enthusiasts, beginners, and the developer community by contributing to open-source projects.

Hacktoberfest_Wallpaper_desktop-02

You can do this in a variety of ways:

  • Prepare and share your project for collaboration
  • Contribute to the betterment of a project via pull requests
  • Organize an event
  • Mentor others
  • Donate directly to open source projects

So what are the various steps to perform in order to participate & get your PRs(Pull Requests) accepted and added to fest?

Here you'll find all these simple questions ! So, let's get started. Let's assume you're a developer who'll participate in this fest & contribute to the open source repos.

Prerequisites

  • GitHub profile
  • Coder/Developer's mindset

Steps to perform

Registeration

  1. The very first thing is to login into your github profile in your browser.
  2. Navigate to the Hacktober Fest 2021 url.
  3. Sign Up with your github profile. (You may also use your gitlab profile)
  4. Click on Start Hacking button.
  5. Here marks the ending of registeration part in Hacktobert Fest 2021.

Uploading your project in GitHub account

Created your project in local computer? Let's upload into your github account.

  1. Click on New button in the top-right corner of your account
  2. Put some name for your repo. It'll be unique for your account. Make sure it'll be the name of your project. Don't name it as Elon Musk's son ! :laugh:
  3. Click on Add File button & select Upload existing file from dropdown.
  4. Drag & Drop the directory into the space or else Browse through the computer to upload full directory. Don't upload files individually.
  5. Click on Commit changes button to upload & save repo.
  6. Your repo with the required files is uploaded with complete content.

P.S. - Make sure you've uploaded README.MD file for attractive look of your repo.

Find repos who're participating in Hacktober Fest 2021 so that your work will be added in this fest

  1. Go to search bar of GitHub
  2. Search for hacktoberfest2021
  3. Chose any one of them.

My Suggestion: If you're a fresher, just search for the repo having some simple programs. Search with the required language which you're more familiar.

How to raise an Issue before raising PR

Question should be why to raise an issue before PR. Answer is simple - Maybe your idea/code maybe already contributed by other fellow developer.
         OR
Maintainer doens't want particular type of code/project in his repo. So, he can deny for that Pull Request.

  1. Click on Issue tab
  2. Click on New Issue button
  3. Give necessary information about your idea of new project which you want to contribute
  4. Click on Raise Issue button in bottom
  5. Moderator/Maintainer will review the issue/idea for project & assign you with a Issue no. (for eg. - #35)
  6. Mention the Issue no in Pull Request for better maintainibility.

How to upload your own projects & contribute to open-source

  1. Hope you've found the repo you want to contribute. Go to the repo & click on fork button on the top-right corner.

  2. GitHub will ask where to fork it. Click on your username/repo-name link

  3. Upload the necessary folder/files in the specified place in repo.

That's it programmer !

How to do a PR (Pull Request) ?

Don't think too much, if you've successfully completed 4 PRs in same repo also, you'll be eligible for that swag/tshirts by Digital Ocean. :happy:

  1. After uploading the folder/files, click on Pull Request button in top corner.

  2. Click on New Pull Request. image

  3. Make sure New Pull Request should not be conflicting ones. Mostly, it doesn't but be sure. image

  4. Give necessary information about your newly added files/folder which you've created.

  5. Click on Create Pull Request button to complete the overall Pull Request. image

  6. Now,your job is completed. Moderator/Maintainer of the repo will review the project & once satisfied, he'll merge the commit into main branch.

Login to Hacktober fest 2021 & see the updated status of the Pull Requests by you.

Project name Status

This will be the format under Contributions Tab.




This is my leaderboard for this year on 04/10/2021 🔽 image

Below is my tracker for today i.e. 04/10/2021 🔽 image

I've tried to cover every small detail I've gone through. If anyone have doubt do raise an issue, I'll try to cover that also. If you've any questions, they're also welcomed !

Author

Nitin Kumar