مشروع مخصص لتسهيل فهم آلية المساهمة في المصدر المفتوح للمبرمجين العرب.
first-contribution-arabic's Introduction
طريقة المساهمة
حتى تبدأ بالمساهمة قم باتباع الخطوات التالية:
١- قم بعمل Fork
قم بالضغط على زر fork لعمل نسخة مستقلة من المستودع بحيث تكون خاصة بك و تابعة لحسابك
٢- قم بتأكيد البيانات و الضغط على fork
لا تحتاج إلى تغيير أي من البيانات الظاهرة و يمكنك الضغط على fork مباشرة
٣- سيتم إنشاء نسخة جديدة من المشروع
لاحظ ظهور اسمك و من ثم اسم المستودع مما يعني أنك حصلت على نسخة مستقلة من المشروع أصبحت تابعة لحسابك الشخصي.
٤- قم بتنزيل المشروع
يتم التنزيل من خلال الضغط على زر code و من ثم اختيار أحد خيارات التحميل مثل: download zip.
٥- افتح المشروع في في محرر الأكواد
يمكنك اختيار محرر الأكواد المناسب لك، قم بفتح المشروع من خلاله و من ثم توجه إلى ملف ال readme.md.
٦- حدد الجزء المطلوب و قم بنسخه
ستجد المكان الذي يحددلك مكان النسخ حيث يجب عليك النسخ من بداية ال <tr> و صولا إلى نهايته </tr>
٧- قم باللصق و تحديث البيانات
تأكد من تحديث البيانات بعد اللصق و قم بحدف بيانات حساباتك في المنصات التي لا تريد لها أن تظهر.
٨- قم بعمل git init في حال لم تقم بالتنزيل باستخدام git clone....
ستحتاج هذا الأمر في حال اتبعت طريقة التنزيل اليدوية المذكورة في هذا الشرح عن طريق (donwload zip file).
٩- قم بعمل git add . و من ثم git commit لحفظ التغييرات.
هذا سيقوم بحفظ التغييرات لديك محليا في الجهاز استعدادا لرفعها للمستودع (الخاص بك)
١٠ - في حال تنزيلك للمستودع بالطريقة اليدوية عليك أن تقوم بإضافة ال remote
لن يعمل معك أمر git push origin main مباشرة في حال التنزيل اليدوي و إنما عليك أن تقوم بإضافة ال remote أولا،
و المقصود بذلك أن تحدد المستودع من github الذي يمثل المكان الذي سيتم رفع الكود إليه في حال تم عمل git push origin main.
و ذلك من خلال نسخ الرابط من زر code من نسخة المستودع الخاصة بك و من ثم استخدامه في الأمر التالي:
git remote add origin <your rep url here>
١١- قم برفع التغييرات إلى مستودعك
قم برفع التغييرات باستخدام الأمر: git push origin main.
هذا سيقوم برفع التغييرات إلى نسختك من المستودع و ليس إلى النسخة الأصلية التي قمت بعمل ال Fork منها.
١٢- قم بفتح نسخة المستودع الخاصة بك
تأكد أنك فتحت نسخة المستودع الخاصة بحسابك في github و ليس النسخة الأصلية من المشروع، ستلاحظ أن التغيير الذي قمت بعمله قد تم إضافته
١٣- قم بعمل ال Pull Request
قم بعمل ال pull request كما هو موضح في الصورة و هي طريقة لطلب اعتماد التغيير الذي قمت به في النسخة الأصلية من المشروع.
١٤- قم بإرسال ال Pull Request
قم بتعبئة البيانات كما هو موضح في الصورة و من ثم اعتمد إرسال ال pull request عن طريق الضغط على create pull request.
١٥- انتظر حتى يتم اعتماد طلبك
بعد ذلك سيصل طلبك إلي و في حال عدم وجود أية ملاحظات فسأقوم باعتماده ليصبح جزءًا من المشروع الأصلي و يتم إضافتك إلى قائمة المساهمين، حينها ستكون قد أتممت مساهمتك الأولى في المصدر المفتوح. 👌🏻😄