Welcome to the world of open sources?
At the beginning of any new project, especially open source, you will go through many problems and will fall into a lot of mistakes, and this will make you feel annoyed and bored, but do not worry and do not get upset a lot, because the goal of our project is to simplify the way for your first contribution in this interesting world.
You can read some of the articles and watch videos in order to know how to take your first steps, but this will take a lot of time and often you will forget what you read if you do not do anything to prove that information in your memory and not to mention the feeling of fear of going through your first experience in this vast world with other people who follow your steps.
And for this we suggest that you contribute to this project and follow the following steps, in order to discover yourself and enjoy participating in your first open source project.
If you do not have the GIT control system on your device, please read this article, and return back to us, how is Git?
Separate this warehouse - Fork this Repository
By clicking on FORK, you create your (your) warehouse on the account of the Github from the main project, and you can now add your own touch.
This warehouse is reproduced
You can now download your version on your device. Click on Clone, then click on Copy to Clipboard icon
Open the Terminal and write this, but replace the phrase "Url You Just Copied" with the link that I copied from the previous step.
An example of illustration (before the amendment):
git clone "url you just copied"
An example of illustration (after amendment):
git clone https://github.com/this-is-you/first-contributions.git
Note:
If you look carefully, you will find that 'this-vi-y' will be the name of your GitHub (your), and you will do for this matter the contents of the project will be copied on your own device in order to adjust it freely at any time.
Make your own branch - Create A Branch
After creating your copy of your previous steps .. Go to the previously downloaded folder
We will create a "branch" and you will change (your-name) to your name
git checkout -b "add-your-name"
An example:
git checkout -b "add-alonzo-church"
You can now change what you want
Let's register your first contribution by adding your name to the list of shareholders.
Open the file called "Contrabutors.MD" and write your name and do not forget to put the link of your Github (your) and when you are finished, make sure that you saved these changes.
Go to the Stminal and write this ( git status ) to show you the changes you made in the project.
To add the changes I made, write this ( git add )
Add and explain changes - Commit Changes To Github
You will explain and explain the changes that you made by writing them through this ( git commit ), which will be replaced ( <your-name> ) in your name
git commit -m "Add <your-name> to Contributors list"
Changes - Push Changes to Github
We will raise the changes I made using this ( git push ) and replace ( add-your-name ) in the name of the branch that created it
git push origin "add-your-name"
Hand Over Your Changes on GitHub
Inside your own page, specifically on the project page on Github, click the Compare & pull request button
As shown in the picture, changes will be delivered in the form of a request for the owner of the main project and he will review it in order to reside for these changes
Merge Your Changes on Github
After the review, the changes you made for the main branch in the project will be combined and you will be alerted by email this
Our congratulations! I have completed the usual procedures ( fork -> clone -> edit -> pull request ) to be ready to participate in any open source project
Sources to learn from them
If you want, you can look at these sources to help you
