مرحبا بك في عالم المصادر المفتوحة ?
عند بداية اي مشروع جديد وبالاخص مفتوح المصدر, سوف تمر بمشاكل عديدة و سوف تقع في الكثير من الاخطاء, و هذا سوف يجعلك تشعر بالانزعاج و الملل, و لكن لا تقلق ولا تنزعج كثيرا, لان هدف مشروعنا هو تبسيط الطريق لأول مساهمة لك في هذا العالم الشيق.
بامكانك قراءة البعض من المقالات و مشاهدة الفيديوهات لكي تعرف كيف تخطو خطواتك الاولي, ولكن هذا سوف ياخذ الكثير من الوقت و غالبا سوف تنسي ما قراته اذا لم تصنع شيئا لتثبت تلك المعلومات في ذاكرتك و ناهيك عن الشعور بالخوف من خوض اول تجربة لك في هذا العالم الشاسع رفقة اناس اخرين يتابعون خطواتك.
و لهذا نقترح عليك المساهمة في مشروعنا هذا و اتباع الخطوات التالية, لكي تكتشف بنفسك و تستمتع بالمشاركة في اول مشروع مفتوح المصدر لك.
اذا لم يكن لديك علي جهازك نظام التحكم Git فتفضل بقراءة تلك المقالة, وعاود الرجوع الينا كيف تعد Git ؟
افصل هذا المستودع - Fork this Repository
بضغطك علي Fork فانك انشات المستودع (الخاص بك) علي حساب ال Github من المشروع الرئيسي و بامكانك الان اضافة لمستك الخاصة.
استنسخ هذا المستودع - Clone the repository
بامكانك الان تحميل النسخة الخاصة بك علي جهازك.
انقر على 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 (الخاص بك), وبفعلك لهذا الامر سيتم نسخ محتويات المشروع علي جهازك الخاص لكي تعدل عليه بحرية في أي وقت.
قم بعمل فرع خاص بك - Create a branch
بعد انشاء نسختك الخاصة بك من الخطوات السابقة .. انتقل للفولدر الذي تم تحميله مسبقا
سنقم بانشاء "فرع" و سوف تغير (your-name) الي اسمك
git checkout -b "add-your-name"
مثال توضيحي:
git checkout -b "add-alonzo-church"
بامكانك الان تغير ما تريد - Create changes on Github
لنقم بتسجيل اول مساهمة لك عن طريق اضافة اسمك لقائمة المساهمين "Contributors.md" عن طريق المحرر المفضل لك "text editor"
قم بفتح الملف الذي يسمي "Contributors.md" و اكتب اسمك و لاتنسي وضع رابط حساب ال Github (الخاص بك) و عند الانتهاء تاكد انك حفظت تلك التغيرات.
اذهب للترمينال واكتب هذا الأمر ( git status ) لكي يظهر لك التغيرات التي قمت بها في المشروع.
لكي نضيف التغيرات التي قمت بها, اكتب هذا الامر (git add)
اضافة و شرح التغيرات - Commit changes to Github
سوف توضح و تشرح التغيرات التي قمت بها عن طريق كتابتها عبر هذا الامر (git commit) و التي ستكون ان تستبدل (<your-name>) باسمك
git commit -m "Add <your-name> to Contributors list"
رفع التغيرات - Push changes to Github
سنرفع التغيرات التي قمت بها باستخدام هذا الامر (git push) و تستبدل (add-your-name) باسم الفرع الذي انشاته
git push origin "add-your-name"
تسليم التغيرات للمراجعة - Hand over your changes on Github
بداخل صفحتك الخاصة و بالتحديد في صفحة المشروع على Github, انقر على زر (Compare & pull request)
كما هو موضح في الصورة, سوف تسلم التغيرات في هيئة طلب لصاحب المشروع الرئيسي وهو سيراجع عليها لكي يقيم لتلك التغيرات
مرحلة الدمج - Merge your changes on Github
بعد المراجعة سوف يتم دمج التغيرات التي قمت بها للفرع الرئيسي في المشروع و سوف يتم تنبيهك عن طريق البريد الإلكتروني بهذا
تهانينا الحارة! لقد اكملت الاجراءات المعتاده (fork -> clone -> edit -> pull request) لكي تصبح جاهز للمشاركة في اي مشروع مفتوح المصدر
اذا تريد, فيمكنك القاء نظرة علي تلك المصادر لمساعدتك
