A project to help new developers to get started with GitHub with first Pull Request
It's difficult when you do something for the first time.Like riding a bicycle, learning to cook or working on a new project. We make mistakes and mistakes are ok as they help us learn as said by ๐ก Thomas Eddison "I have not failed. I've just found 10,000 ways that won't work.".
But working on collaborative projects can be a hassle and we don't want to make mistakes to show that we are good developers. As open source is all about collaboration and working together.That is why this project was created to help new developers to make their first contribution and start their journey as a developer and contributing to the open source.
That's true you can watch and learn. But what's a better way to learn than getting hands-on experience & experiment by start contributing straight away?This project aims to provide beginners a simplified way to start contributing to open source.So If you are looking to make your first contribution to open source.This is the right place. Follow the following steps to get you started.
If you don't have git, install it from here.
Fork this repository by click on fork button on the top right corner of this page. This will create a copy of this repository in your account.
- Now you are at your forked repository at your profile.
- At the right side corner find clone or download button
- Now clone this repo to your machine. Click on the clone button and then click the copy to clipboard icon.
- Now go to location on your computer where you want to store the local copy of this repository,where you will work on it.
- After this, right click and select git bash here
- A terminal will open, see that the path is the same path where you want to clone.
- Now run the following command:
--
git clone url-you-copied
For eg:
git clone https://github.com/your-github-username/First_Contribution.git
where your-github-username
is your GitHub username.
Change to the repository directory on your computer (if you are not already there):
cd First_Contribution
Now create a branch using the git checkout
command:
git checkout -b <add-your-full-name>
For example:
git checkout -b add-anthony-gonzalviz
Now open Contributors.md
file in a text editor. Refer to this cheat sheet which gives information on how to use Markdown which is used to write in GitHub MD files
In this case, add the following line at the end of Contributors.md:
- [Your-name](https://github.com/Your-username)
Make sure there is no space between ](
. Save the file.
Go again to git bash and go to project directory and execute the command git status
, you'll see there are changes which are unstage. Add those changes to the branch you just created using the git add
command:
git add Contributors.md
Now commit those changes using the git commit
command:
git commit -m "Add <your-name> to Contributors list"
For Example:
git commit -m "Add John Doe to contributors list"
Caution: Don't forget to add -m
it specifies message to commit.If you forget it will take you to vim terminal which is difficult to operate.
Push your changes using the git push
command:
git push origin <add-your-name>
replacing <add-your-name>
with the name of the branch you created earlier.
Now go to your repository on GitHub, you'll see a New pull request
button. Click on that button.
It will compare your branch with the original repository. Check if the comparing branch is your created branch
Now submit the pull request.
Soon I'll be merging all your changes into the master branch of this project.
Cheers ๐
You created your first contribution to open source ๐
If you like this please star this repository
-
If you want to contribute more I am creating a starters project to create a awareness website. Visit
-
I will be needing translation for this in other languages to help other developers to contribute.(Will be added soon)
-
You can work on other projects just search the organisation you like and see for "Good First Issue". -To start of FreeCodeCamp is a good place they need help with guide and Non-Profit projects Link
Note : Always read ReadMe.md file of the projects it contains the instructions for working up and setting up of the projects.
Here some good and free tutorials to learn
-
Git/GitHub
-
HTML & CSS