|
| 1 | +# How to begin with hacktober fest 2021 |
| 2 | + |
| 3 | +> Hacktoberfest encourages participation in the open source community, which grows bigger every year. Complete the 2021 challenge and earn a limited edition T-shirt. |
| 4 | + |
| 5 | +> 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. |
| 6 | + |
| 7 | + |
| 8 | + |
| 9 | + |
| 10 | +You can do this in a variety of ways: |
| 11 | + |
| 12 | +- Prepare and share your project for collaboration |
| 13 | +- Contribute to the betterment of a project via pull requests |
| 14 | +- Organize an event |
| 15 | +- Mentor others |
| 16 | +- Donate directly to open source projects |
| 17 | + |
| 18 | +**So what are the various steps to perform in order to participate & get your PRs(Pull Requests) accepted and added to fest?** |
| 19 | + |
| 20 | +*Here you'll find all these simple questions ! |
| 21 | +So, let's get started. Let's assume you're a developer who'll participate in this fest & contribute to the open source repos.* |
| 22 | + |
| 23 | +# Prerequisites |
| 24 | + |
| 25 | +- [ ] GitHub profile |
| 26 | +- [ ] Coder/Developer's mindset |
| 27 | + |
| 28 | +# Steps to perform |
| 29 | + |
| 30 | +### **Registeration** |
| 31 | +1. The very first thing is to login into your github profile in your browser. |
| 32 | +2. Navigate to the [Hacktober Fest 2021](https://hacktoberfest.digitalocean.com/) url. |
| 33 | +3. Sign Up with your github profile. (You may also use your gitlab profile) |
| 34 | +4. Click on Start Hacking button. |
| 35 | +5. Here marks the ending of registeration part in Hacktobert Fest 2021. |
| 36 | + |
| 37 | +--- |
| 38 | +### **Uploading your project in GitHub account** |
| 39 | + |
| 40 | +Created your project in local computer? Let's upload into your github account. |
| 41 | + |
| 42 | +1. Click on New button in the top-right corner of your account |
| 43 | +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: |
| 44 | +3. Click on Add File button & select Upload existing file from dropdown. |
| 45 | +4. Drag & Drop the directory into the space or else Browse through the computer to upload full directory. Don't upload files individually. |
| 46 | +5. Click on Commit changes button to upload & save repo. |
| 47 | +6. Your repo with the required files is uploaded with complete content. |
| 48 | + |
| 49 | +*P.S. - Make sure you've uploaded README.MD file for attractive look of your repo.* |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +### **Find repos who're participating in Hacktober Fest 2021 so that your work will be added in this fest** |
| 54 | + |
| 55 | +1. Go to search bar of GitHub |
| 56 | +2. Search for hacktoberfest2021 |
| 57 | +3. Chose any one of them. |
| 58 | + |
| 59 | +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. |
| 60 | + |
| 61 | +--- |
| 62 | + |
| 63 | +### **How to raise an Issue before raising PR** |
| 64 | + |
| 65 | +> Question should be why to raise an issue before PR. Answer is simple - Maybe your idea/code maybe already contributed by other fellow developer. |
| 66 | +         OR |
| 67 | +Maintainer doens't want particular type of code/project in his repo. So, he can deny for that Pull Request. |
| 68 | + |
| 69 | +1. Click on Issue tab |
| 70 | +2. Click on New Issue button |
| 71 | +3. Give necessary information about your idea of new project which you want to contribute |
| 72 | +4. Click on Raise Issue button in bottom |
| 73 | +5. Moderator/Maintainer will review the issue/idea for project & assign you with a Issue no. (for eg. - #35) |
| 74 | +6. Mention the Issue no in Pull Request for better maintainibility. |
| 75 | + |
| 76 | +--- |
| 77 | + |
| 78 | +### **How to upload your own projects & contribute to open-source** |
| 79 | + |
| 80 | +1. Hope you've found the repo you want to contribute. Go to the repo & click on fork button on the top-right corner. |
| 81 | + |
| 82 | +2. GitHub will ask where to fork it. Click on your `username/repo-name` link |
| 83 | + |
| 84 | +3. Upload the necessary folder/files in the specified place in repo. |
| 85 | + |
| 86 | +*That's it programmer !* |
| 87 | + |
| 88 | +--- |
| 89 | + |
| 90 | +### **How to do a PR (Pull Request) ?** |
| 91 | +> 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: |
| 92 | + |
| 93 | +1. After uploading the folder/files, click on Pull Request button in top corner. |
| 94 | +2. Click on New Pull Request. |
| 95 | +  |
| 96 | + |
| 97 | +3. Make sure New Pull Request should not be conflicting ones. Mostly, it doesn't but be sure. |
| 98 | +  |
| 99 | + |
| 100 | +5. Give necessary information about your newly added files/folder which you've created. |
| 101 | + |
| 102 | +6. Click on Create Pull Request button to complete the overall Pull Request. |
| 103 | +  |
| 104 | + |
| 105 | +7. Now,your job is completed. Moderator/Maintainer of the repo will review the project & once satisfied, he'll merge the commit into `main` branch. |
| 106 | + |
| 107 | +--- |
| 108 | + |
| 109 | +Login to [Hacktober fest 2021](https://hacktoberfest.digitalocean.com/) & see the updated status of the Pull Requests by you. |
| 110 | + |
| 111 | +> | Project name | Status | |
| 112 | +> |---|---| |
| 113 | + |
| 114 | +This will be the format under Contributions Tab. |
| 115 | + |
| 116 | +<br><br><br> |
| 117 | + |
| 118 | +**This is my leaderboard for this year on 04/10/2021** 🔽 |
| 119 | + |
| 120 | + |
| 121 | +**Below is my tracker for today i.e. 04/10/2021** 🔽 |
| 122 | + |
| 123 | + |
| 124 | + |
| 125 | +--- |
| 126 | + |
| 127 | +> 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 ! |
| 128 | + |
| 129 | +# Author |
| 130 | + |
| 131 | +[Nitin Kumar](https://github/com/nitinkumar30/) |
| 132 | + |
| 133 | + |
| 134 | + |
| 135 | + |
0 commit comments