Road-to-OSS
Learn some basic workflow of git and GitHub in a few steps. Afterward, let's start contributing to several open-source projects. And be a part of hackctober fest also.
To know about hacktoberfest click here
Requirements
Note: If you want to be a part of hackctoberfest complete registration and authorization before your pull request.
Step 1 - Fork this repository
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.
Step 2 - Clone the forked repository
Now clone the forked repository to your machine:
- Using HTTPS
git clone "https://GitHub.com/<your-username>/Road-to-OSS.git"
- Using SSH
git clone "git@GitHub.com:<your-username>/Road-to-OSS.git"
Note: Replace with your GitHub username.
Step 3 - Create a branch
Change the current working directory to the cloned repo. For example:
cd Road-to-OSS
Now create a new branch with the below naming convention:
git switch -c add-your-name
For example:
git switch -c add-shaheen-hyder
Step 4 - Make changes and commit
- Edit the
info.json
file in the project directory to include your information.
[
......
{
# info of previous user
},
{
"name": "John Doe", # Your name -> No longer than 30 characters
"gh_username": "johndoe" # Your GitHub username
"place": "New York", # Your place -> No longer than 30 characters
"current_pos": "Web developer", # Your current position (student/freelancer/working etc.) -> No longer than 58 characters
"image": "johndoe.png", # Name of your portrait image added in the /images directory -> Image size not greater than 200KB
"bio": "Hi, I'm John! I'm a web developer with in-depth experience in UI/UX design." # A short bio of you -> No longer than 150 characters
}
]
NOTE:
make sure to add your info at the end of the file, after the last user's data. Not in the middle or the top of the file so that we can test the data. Otherwise the PR will be closed!
- Add a portrait image of you with your name and add it to the
images/
directory. If you don't want to add an image usenull
in the json file - Image size should not be greater than 200KB
- For the best result use a image with 1:1 ratio
{
...
"image": null
...
}
Now if you go to the project directory and enter the command git status
, you can see the changes.
Add those changes with the git add
command:
git add -A
Now commit those changes using the git commit
command:
git commit -m "Add <your-name> to contributors list"
For example:
git commit -m "Add Shaheen Hyder to contributors list"
Step 5 - Push the changes to GitHub
Push your changes to GitHub using the git push
command:
git push -u origin <your-branch-name>
For example:
git push -u origin add-shaheen-hyder
If you enabled two-factor authentication in your GitHub account you won't be able to push via HTTPS using your accounts password. Instead you need to generate a personal access token. This can be done in the application settings of your GitHub account. Using this token as your password should allow you to push to your remote repository via HTTPS. Use your username as usual.
Creating a personal access token
Step 6 - Submit your changes for review
If you go to your repository page on GitHub you will see a compare & pull request
button. Click that button.
And submit the pull request.
Soon the reviewer will merge the branch into main
.
Step 7 - View and share contributors badge
Once the PR is merged you can view your details here. You can download your profile and share it on social media.
Don't forget to tag Pygrammers :)
What after that?
Start contributing!
- Check out repos with hacktoberfest topic:
- Explore Projects with issues:
- Explore Hacktoberfest projects:
If this repo helped you get better at open source contributions, consider giving us a star and share the knowledge with your friends :)