الصعوبة متوقعة عندما تبدأ بأي عمل جديد، خصوصاً إذا كان العمل يتضمن أشخاصًا آخرين، مما يجعل الوقوع في الخطأ مزعجًا.
لكن المساهمة في مشاريع مفتوحة المصدر يتطلب ويتوقع الخطأ ولهذا السبب سيساعدك الآخرون في تصحيح هذا الخطأ.
في هذا المشروع هدفنا هو تسهيل الطريق لمساهمتك الأولى.
لكن المساهمة في مشاريع مفتوحة المصدر يتطلب ويتوقع الخطأ ولهذا السبب سيساعدك الآخرون في تصحيح هذا الخطأ.
في هذا المشروع هدفنا هو تسهيل الطريق لمساهمتك الأولى.
قراءة ومتابعة التعليمات المتاحة على الإنترنت ستساعدك بالتأكيد. ومع ذلك، ستستفيد بشكل أكبر إذا استطعت المشاركة في مشروع معين دون الخوف من الوقوع في الأخطاء. يهدف هذا المشروع إلى تقديم توجيهات وإرشادات أولية لمساعدتك في البدء بأول مساهمة لك.
تذكر أن الخطأ أمر متوقع، والهدف الأسمى هو التعلم من هذه البيئة. نشجعك على أن تركز أثناء متابعة الخطوات التالية لإكمال مساهمتك الأولى. نعدك بأنك ستستمتع بالتجربة وسوف تستفيد منها
إذا لم يكن لديك git على الجهاز الخاص بك،قم بتثبيته من هنا
افرق هذا المشروع بالضغط على زر Fork في أعلى هذه الصفحة.
من خلال ذلك ستنشأ نسخة من هذا المشروع على حسابك الخاص.
استنسخ هذا المشروع على جهازك.
انقر على زر Clone ثم انقر على أيقونة Copy to clipboard
افتح terminal واكتُب الأمر التالي:
git clone "url you just copied"
قم باستبدال "url you just copied" بالرابط الذي نسخته من الخطوة السابقة، هذا الرابط يحتوي على المشروع.
على سبيل المثال:
git clone https://github.com/this-is-you/first-contributions.git
في هذا المثال لاحظ 'this-is-you' سيكون اسم حسابك في موقع github يليه رابط المشروع الذي فرقته في أول خطوة، هذا الأمر سينسخ محتويات المشروع على جهازك لتتمكن من التعديل عليه بحرية.
انتقل إلى المجلد الذي يحتوي على المشروع عن طريق الأمر التالي:
cd first-contributions
الآن قم بإنشاء فرع عن طريق الأمر التالي:
git checkout -b "add-your-name"
اسمك بدل add-your-name
على سبيل المثال:
git checkout -b "add-alonzo-church"
الآن قم بفتح الملف "Contributors.md" في محرر النصوص المفضل لديك وأضف اسمك ثم احفظ الملف.
بعد ذلك اذهب إلى terminal واكتب الأمر
git status
. هذا الأمر سيظهر لك التغييرات التي حدثت في المشروع.
لإضافة هذه التغييرات قم بإضافتها عن طريق هذا الأمر git add
.
git add Contributors.md
الآن قم بإتمام التغييرات باستخدام الأمر
git commit
.git commit -m "Add <your-name> to Contributors list"
استبدل
<your-name>
باسمك. ارفع التغييرات عن طريق الأمر
git push
git push origin "add-your-name"
استبدل
<add-your-name>
باسم الفرع الذي أنشأته من قبل.في صفحة المشروع الخاصة بك يوجد زر
Compare & pull request
. اضغط على هذا الزر.والآن سلم طلبك لتتم مراجعته
بعد المراجعة سوف أقوم بدمج تغييراتك إلى الفرع الرئيسي في المشروع. سيتم تنبيهك عن طريق البريد الإلكتروني بذلك.
الفرع الرئيسي الخاص بك لن يحتوي على هذه التغييرات. عليك مزامنته مع الفرع الرئيسي عن طريق الخطوات التالية.
الخطوة الأولى، انتقل إلى الفرع الرئيسي.
git checkout master
ثانياً، أضف رابط مشروعي كـ
upstream remote url
.git remote add upstream https://github.com/Roshanjossey/first-contributions
بهذه الطريقة نخبر git أن هناك نسخة أخرى من هذا المشروع في هذا الرابط ونسميها
upstream
.
بعد أن أوافق على تغييراتك، قم بسحب النسخة الجديدة من المشروع عن طريق الأمر التالي:
git fetch upstream
هنا سنقوم بسحب جميع التغييرات من
(upstream remote)
. والآن، عليك أن تدمج التحديثات الجديدة من فرعي إلى فرعك الرئيسي.git rebase upstream/master
وهنا تطبق التغييرات إلى الفرع الرئيسي. إذا رفعت التغييرات لفرعك الرئيسي سيتم تحديث مشروعك
git push origin master
لاحظ أنك ترفع إلى
remote
اسمه origin
.GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |