README.ar.md

[](https://github.com/ellerbrock/open-source-badges/)[](https://firstcontributions.herokuapp.com)

مساهمتك الأولى

الصعوبة متوقعة عندما تبدأ بأي عمل جديد، خصوصاً إذا كان العمل يتضمن أشخاص آخرون، مما يجعل الوقوع في الخطأ مزعج. لكن المساهمة في مشاريع مفتوحة المصدر يتطلب ويتوقع الخطأ ولهذا السبب الآخرون سياعدونك في تصحيح هذا الخطأ. في هذا المشروع هدفنا هو تبسيط الطريق لمساهمتك الأولى.

القرائة ومشاهدة التعلميات المتوفرة على الإنترنت ستساعدك حتماً، لكنك ستسدفيت أكثر إذا إستطعت المساهمة في مشروع بدون الخوف من الوقوع في الخطأ. هذا المشروع يركز على توفيرك بالتوجيهات والتعليمات البسيطة لإتمام أول مساهمة. تذكر أن الخطأ متوقع والهدف أنك تتجاوز الخطأ في هذه البيئة، نريد منك أن تكون مسترخي ومتابعة الخطوات المتوفرة لإتمام مشاركتك الأولى. نوعدك ستسمتع بذلك.

Read this in other languages: English, Spanish, Dutch, Hindi, Russian, Japanese, Vietnamese, Polish, Korean, German, Simplified Chinese, Traditional Chinese, Greek.

إذا لم يكن لديك جت على الجهاز الخاص بك، [ قم بتثبيته من هنا ]( https://help.github.com/articles/set-up-git/ )

إفرق هذا المشروع - Fork this Repository

إفرق هذا المشروع بالضغط على زر Fork في أعلى هذه الصفحة. من خلال ذلك ستنشأ نسخة من هذا المشروع في حسابك الخاص.

إستنسخ هذا المشروع - Clone the repository

استنسخ هذا المشروع إلى جهازك. انقر على زر Clone ثم انقر على أيقونة Copy to clipboard

إفتح التريمنال وأكتب الأمر التالي:

git clone "url you just copied"

قم بإستبدال "url you just copied" بالرابط الذي نسخته من الخطوة السابقة، هذا الرابط يحتوي على المشروع.

على سبيل المثال:

git clone https://github.com/this-is-you/first-contributions.git

في هذا المثال لاحظ 'this-is-you' سيكون إسم حسابك في موقع جيت هاب يتليه رابط المشروع اللذي فرقته في أول خطوة، الأمر هذا سينسخ محتويات المشروع إلى جهازك الخاص لتتمكن من التعديل عليه بحريه.

إنشاء فرع - Create a branch

إنتقل إلى المجلد الذي يحتوي على المشروع عن طريق الأمر التالي:

cd first-contributions

الآن قم بإنشاء فرع عن طريق الأمر التالي:

``` git checkout -b ```

إسمك بدل add-your-name

على سبيل المثال:

``` git checkout -b add-alonzo-church ```

قم بإجراء التعديلات المطلوبة وأتممها

Now open Contributors.md file in a text editor and add your name to it, then save the file. If you go to the project directory and do git status, you'll see there are changes. Add those changes using the below git add command.

git add Contributors.md

Now commit those changes using the below git commit command.

git commit -m "Add <your-name> to Contributors list"

replace <your-name> with your name

Push changes to GitHub

Push your changes using git push

git push origin <add-your-name>

Replace <add-your-name> with the name of the branch you created earlier

Submit your changes for review

If you go to your repository on GitHub, you'll see Compare & pull request button. click on that button.

Now submit the pull request.

Now I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged.

Master branch of your fork won't have those changes. In order to keep your fork synced with mine, follow the steps below.

Keeping your fork synced with this repository

First, switch to master branch.

git checkout master

Then, add my repo's url as upstream remote url.

git remote add upstream https://github.com/Roshanjossey/first-contributions

This is a way of telling git that another version of this project exists in the specified url and we're calling it upstream. Once the changes are merged, fetch the new version of my repository.

git fetch upstream

Here we're fetching all the changes in my fork (upstream remote). Now, you need to merge the new revision of my repository into your master branch.

git rebase upstream/master

Here you're applying all the changes you fetched to master branch. If you push master branch now, your fork will also have the changes

git push origin master

Notice here you're pushing to the remote named origin.

Tutorials Using Other Tools

GitHub Desktop	Visual Studio 2017	GitKraken

Where to go from here?

You could also join our slack team in case you need any help or have any questions. Join slack team

Here's some beginner level issues in popular repos that you can solve. Go ahead and go to those repos to learn more

exercism	Fun Retros	react	habitat	scikit-learn	Leiningen	numpy	elasticsearch
homebrew	Rust	vuejs	Suave	OpenRA	PowerShell	coala	moment
ava	freeCodeCamp	webpack	hoodie	pouchdb	neovim	babel	brackets
Node.js	Semantic-UI-React