عند بداية اي مشروع جديد وبالاخص مفتوح المصدر, سوف تمر بمشاكل عديدة و سوف تقع في الكثير من الاخطاء, و هذا سوف يجعلك تشعر بالانزعاج و الملل, و لكن لا تقلق ولا تنزعج كثيرا, لان هدف مشروعنا هو تبسيط الطريق لأول مساهمة لك في هذا العالم الشيق.
بامكانك قراءة البعض من المقالات و مشاهدة الفيديوهات لكي تعرف كيف تخطو خطواتك الاولي, ولكن هذا سوف ياخذ الكثير من الوقت و غالبا سوف تنسي ما قراته اذا لم تصنع شيئا لتثبت تلك المعلومات في ذاكرتك و ناهيك عن الشعور بالخوف من خوض اول تجربة لك في هذا العالم الشاسع رفقة اناس اخرين يتابعون خطواتك.
و لهذا نقترح عليك المساهمة في مشروعنا هذا و اتباع الخطوات التالية, لكي تكتشف بنفسك و تستمتع بالمشاركة في اول مشروع مفتوح المصدر لك.
اذا لم يكن لديك علي جهازك نظام التحكم Git فتفضل بقراءة تلك المقالة, وعاود الرجوع الينا كيف تعد Git ؟
بضغطك علي Fork فانك انشات المستودع (الخاص بك) علي حساب ال Github من المشروع الرئيسي و بامكانك الان اضافة لمستك الخاصة.
بامكانك الان تحميل النسخة الخاصة بك علي جهازك.
انقر على Clone, ثم انقر على أيقونة Copy to clipboard
قم بفتح الترمينال وأكتب هذا الأمر و لكن قم بتبديل جملة "url you just copied" بالرابط الذي قمت بنسخه من الخطوة السابقة.
مثال توضيحي (قبل التعديل):
git clone "url you just copied"
مثال توضيحي (بعد التعديل):
git clone https://github.com/this-is-you/first-contributions.git
ملحوظة:
اذا امعنت النظر, ستجد ان 'this-is-you' سوف يكون إسم حساب Github (الخاص بك), وبفعلك لهذا الامر سيتم نسخ محتويات المشروع علي جهازك الخاص لكي تعدل عليه بحرية في أي وقت.
بعد انشاء نسختك الخاصة بك من الخطوات السابقة .. انتقل للفولدر الذي تم تحميله مسبقا
cd first-contributions
سنقم بانشاء "فرع" و سوف تغير (your-name) الي اسمك
git checkout -b "add-your-name"
مثال توضيحي:
git checkout -b "add-alonzo-church"
لنقم بتسجيل اول مساهمة لك عن طريق اضافة اسمك لقائمة المساهمين "Contributors.md" عن طريق المحرر المفضل لك "text editor"
قم بفتح الملف الذي يسمي "Contributors.md" و اكتب اسمك و لاتنسي وضع رابط حساب ال Github (الخاص بك) و عند الانتهاء تاكد انك حفظت تلك التغيرات.
اذهب للترمينال واكتب هذا الأمر (
git status ) لكي يظهر لك التغيرات التي قمت بها في المشروع.
لكي نضيف التغيرات التي قمت بها, اكتب هذا الامر (git add)
git add Contributors.md
سوف توضح و تشرح التغيرات التي قمت بها عن طريق كتابتها عبر هذا الامر (git commit) و التي ستكون ان تستبدل (<your-name>) باسمك
git commit -m "Add <your-name> to Contributors list"
سنرفع التغيرات التي قمت بها باستخدام هذا الامر (git push) و تستبدل (add-your-name) باسم الفرع الذي انشاته
git push origin "add-your-name"
بداخل صفحتك الخاصة و بالتحديد في صفحة المشروع على Github, انقر على زر (Compare & pull request)
كما هو موضح في الصورة, سوف تسلم التغيرات في هيئة طلب لصاحب المشروع الرئيسي وهو سيراجع عليها لكي يقيم لتلك التغيرات
بعد المراجعة سوف يتم دمج التغيرات التي قمت بها للفرع الرئيسي في المشروع و سوف يتم تنبيهك عن طريق البريد الإلكتروني بهذا
تهانينا الحارة! لقد اكملت الاجراءات المعتاده (fork -> clone -> edit -> pull request) لكي تصبح جاهز للمشاركة في اي مشروع مفتوح المصدر