Skip to content

Latest commit

 

History

History
196 lines (131 loc) · 16 KB

README.ar.md

File metadata and controls

196 lines (131 loc) · 16 KB
Open Source Love

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

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

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

إذا لم يكن لديك جت على الجهاز الخاص بك،قم بتثبيته من هنا

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

fork this repository

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

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

clone this repository

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

copy URL 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"
إسمك بدل add-your-name
على سبيل المثال:
git checkout -b "add-alonzo-church"

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

الآن قم بفتح الملف "Contributors.md" في محرر النصوص المفضل لديك وأضف إسمك ثم إحفظ الملف. بعد ذلك إذهب إلى الترمينال وأكتب الأمر هذاgit status هذا الأمر سيظهر لك التغيرات التي حدثت في المشروع. لإضافة هذه التغيرات قم بإضافتها عن طريق الأمر هذا git add.
git add Contributors.md
الآن قم بإتمام التغيررات بإستخدام الأمر git commit.
git commit -m "Add <your-name> to Contributors list"
إستبدل <your-name> بإسمك.

إرفع التغيررات إلى جت هاب - Push changes to Github

إرفع التغيررات عن طريق الأمر git push
git push origin "add-your-name"
إستبدل <add-your-name> بإسم الفرع الذي أنشأته من قبل.

سلم تغيراتك للمراجعة

في صفحة المشروع الخاصة بك يوجد زر Compare & pull request. إضغط على هذا الزر.

create a pull request

والآن سلم طلبك لتتم مراجعته

submit pull request

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

مزامنة نسختك مع المشروع الرئيسي

الخطوة الأولى، إنتقل إلى الفرع الرئيسي.
git checkout master
ثانياً، أضف رابط مشروعي كـupstream remote url.
git remote add upstream https://github.com/Roshanjossey/first-contributions
بهذه الطريقة نخبر جت أن هناك نسخة أخرى من هذا المشروع في هذا الرابط ونسميها upstream. بعد أن أوافق على تغيرراتك، قم بسحب النسخة الجديدة من المشروع عن طريق الأمر التالي:
git fetch upstream
هنا سنقوم بسحب جميع التغيررات من (upstream remote). والآن، عليك أن تدمج التحديثات الجديدة من فرعي إلى فرعك الرئيسي.
git rebase upstream/master
وهنا تطبق التغيررات إلى الفرع الرئيسي. إذا رفعت التغيررات لفرعك الرئيسي سيتم تحديث مشروعك
git push origin master
لاحظ أنك ترفع إلى remote إسمه origin.

توجيهات بإستخدام أدوات أخرى

GitHub Desktop Visual Studio 2017 GitKraken
GitHub Desktop Visual Studio 2017 GitKraken

ماذا أفعل بعد هذا؟

يمكنك الإنضمام إلى الفريق على Slack إذا أردت أي مساعدة ولديك أي سؤال. إنضم إلى فريق Slack

أيضا إطلع على المشاريع التالي وإبحث عن مشكال أو مميزات يمكنك حلها أو إضافتها، بالتوفيق.
exercism fun-retro habitat scikit-learn elasticsearch
exercism Fun Retros react habitat scikit-learn Leiningen numpy elasticsearch
homebrew rust vuejs Suave OpenRA PowerShell coala moment
homebrew Rust vuejs Suave OpenRA PowerShell coala moment
ava freeCodeCamp webpack hoodie pouchdb neovim babel
ava freeCodeCamp webpack hoodie pouchdb neovim babel brackets
Node.js
Node.js Semantic-UI-React