Hacktoberfest is a golbal challenge, by DigitalOcean to encourage opensource and its contributions.
Open-source software is a type of computer software in which source code is released under a license in which the copyright holder grants users the rights to use, study, change, and distribute the software to anyone and for any purpose. Open-source software may be developed in a collaborative public manner. Wikipedia
However, you don't want to do big things.
If you are a beginner and want to contribute to opensource, but don't know where to start, then you are in the right place.
What is Github? - Github is a platform for hosting software source codes and their version control.
If you don't have a Github account create it from here.
For learning purposes and the Hacktoberfest challenge, I created a repository on Github. - Learn With Cybergenie
Github uses some terminologies for actions made in the repository.
1. Fork : Forking is process of copying orginal repository( files/codes) from the original account to your account.
Now Fork the repo by clicking the Fork button as in the above image.
After forking , a copy is created in your account.
2. Clone : Cloning creates a copy of the source code in your system(Desktop/Laptop). This is for fast and easy editing of the files.
You can either clone the repo by
Git - command line
GitHub Desktop -Gui based (Recommended)
Click Open With Github Desktop, you will be redirected to Github desktop application. Select a folder to save the files and wait for the cloning to finish.
3. Branch : Branches make it easy to edit the files without changing the main code. When creating a new branch a copy is of the code created on your system , and you are making changes to this copy, so in case you did anything wrong on the new branch, you can delete the branch and your master branch is safe.
You can name the new branch a custom name(eg:hacktoberfest-edits). You can switch between branches or create new branches if needed.
4. Commit & Push : Committing is saving the changes you made to the code, the changes will get commited to current branch you are working. If you committed then only the changes will get saved or else when you switch between branches it will get lost.
Pushing the changes to your repository - the files on your system is now offline, after made enough changes its time to upload/push the changes to your online repo.
5. Pull Request : Now it's time to pull request, which is needed for Hacktoberfest. A pull request is a request to propose the changes you made to the original repo.
After you pushed your changes as step 4,
open the forked repo in Github.com and as you can see,similar in the above image, an option appears Compare & pull request.
Click on it, write a title(eg: Fix filename.py) to the request enter a description and Create pull request
5. Merge : As the name , merging is a process where the changes are merged into the master/main code.
The repo Learn With Cybergenie contains different files. Depending on your flavor you can choose any programming language.
If you are a beginner you can create a pull request by fixing English grammar mistakes in the files.
• English mistakes
- Registration is required for all participant-Register
2. Atleast 4 pull request is needed to complete the challenge
3. T-shirt is provided as first come first method
4. The pull requests made form October 1-30 will be only counted to Hacktoberfest.