المساهمة في مشاريع GitHub (Git Pull Request for Dummies)

لقد واجهت مشروعًا على موقع جيتهاب وتود المساهمة في هذا المشروع. ولكن كيف؟ لا تعتبر نفسك مطورًا ومصطلحات التحكم في المصدر غريبة عليك. لا تقلق. الإجابة هي طلب سحب (PR) في جيت.

في هذا البرنامج التعليمي، ستتعلم كيفية المساهمة في مشروع جيتهاب باستخدام طلب سحب في جيت للحصول على كودك في مستودع جيتهاب (مستودع)

المساهمة في مشروع جيتهاب

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

كانت جيت وجيتهاب تقليديًا في مجال التطوير. ولكن مع انتقال المزيد والمزيد من البنية التحتية إلى السحابة وظهور أدوات “البنية كشفرة”، بدأ المسؤولون في استكشاف المزيد في جيتهاب.

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

ما هو طلب السحب؟

عندما يكون لديك كود/إصلاح سيضيف المزيد من الوظائف أو يضيف قيمة أكبر لمشروع أو مستودع موجود في جيتهاب، يمكنك إنشاء طلب سحب.

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

1. التفرع أو “نسخ” المستودع الأصلي إلى حساب GitHub الخاص بك

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

2. التزام بالكود في مستودعنا المنشعب الشخصي و دفع هذا الكود إلى مستودع GitHub

3. تقديم طلب سحب إلى مالك المستودع

4. مراجعة مالك المستودع والموافقة على تغييراتك في طلب السحب

5. دمج مالك المستودع لتغييراتك في فرع الرئيسي

المتطلبات الأساسية

لمتابعة العروض التوضيحية في هذا البرنامج التعليمي، تأكد من أن لديك ما يلي:

• A GitHub account
• A GitHub repo to request changes to – This tutorial will use a repo called git-pull-requests.
• Git – سيستخدم هذا البرنامج التعليمي Git على Windows في دليل عمل C:\Git.
• Git إعداد العمل مع حساب GitHub الخاص بك

نسخ مستودع GitHub

بما أنه لا يمكنك إجراء تغييرات مباشرة على مستودع GitHub الخاص بشخص آخر ، فيجب أن تقوم أولاً بإنشاء نسخة خاصة بك. للقيام بذلك ، تحتاج إلى نسخ أو إنشاء نسخة من المستودع تحت حساب GitHub الخاص بك. للقيام بذلك:

1. افتح متصفح الويب المفضل لديك ، انتقل إلى GitHub وقم بتسجيل الدخول.

2. انتقل إلى مستودع البرنامج التعليمي أو المستودع الذي ترغب في المساهمة فيه كما يمكنك رؤية أدناه.

3. في الزاوية العلوية اليمنى ، انقر على زر Fork. سيقوم هذا الزر تلقائيًا بإنشاء نسخة من هذا المستودع في حسابك.

بمجرد أن تتم النسخ ، يجب أن ترى الآن نفس المستودع في قائمة المستودعات الخاصة بك. يمكنك أيضًا رؤية أدناه أن هذا المستودع تم نسخه من Adam-the-Automator\git-pull-requests.

التزام الكود الجديد بنسختك الشخصية

الآن بعد أن لديك نسخة خاصة بك من المستودع في حساب GitHub الخاص بك ، حان الوقت لإجراء التغييرات الخاصة بك. يمكنك إجراء تغييرات على الكود في مستودع GitHub بطريقتين ؛ إما مباشرة عبر github.com أو محليًا عبر Git. دعنا نغطي كلا الطريقتين.

التزام الكود عبر github.com

الطريقة الأسهل لإجراء تغييرات في الشيفرة في مستودع GitHub هي ببساطة استخدام متصفح الويب. باستخدام github.com ، لا داعي للقلق بشأن إعداد أي نوع من البرمجيات محليًا. ومع ذلك ، سيتحول استخدام متصفح الويب إلى صداع قريبًا إذا كنت بحاجة إلى إجراء أي تغييرات معقدة بشكل معتدل.

بافتراض أنك لا تزال تنظر إلى المستودع المُشع عبر المتصفح الخاص بك:

1. انقر على النص البرمجي SampleText.ps1 في المستودع الخاص بك وانقر على أيقونة القلم لتحريره.

2. أجرِ التغيير في الملف وانقر على زر Commit changes كما هو موضح أدناه ، مع إضافة رسالة Commit اختيارية.

التزام الشيفرة عبر Git

إذا كنت تخطط لإجراء أكثر من تغيير بسيط في ملف في مستودع GitHub ، يجب أن تستخدم Git. يتيح لك Git استنساخ المستودع بأكمله إلى جهاز الكمبيوتر المحلي والعمل على الشيفرة في محرر الشيفرة المفضل لديك.

الاستنساخ

للعمل على شيفرة المستودع المشع محليًا ، ستحتاج أولاً إلى استنساخ المستودع بأكمله إلى جهاز الكمبيوتر المحلي باستخدام Git. لفعل ذلك:

بافتراض أنك لا تزال في مستودع الفورك المشع على github.com:

1. انقر على زر Code وانسخ عنوان URL الذي تحت قسم HTTPS.

2. بعد ذلك ، افتح وحدة تحكم الأوامر على جهاز الكمبيوتر الخاص بك. ستستخدم هذا البرنامج التعليمي PowerShell على نظام التشغيل Windows.

3. أنشئ دليلًا لتخزين مستودع الاستنساخ فيه وقم بتشغيل git clone موجهًا إياه إلى عنوان URL الذي تم نسخه من الخطوة السابقة.

md C:\Git
 cd C:\Git
 git clone https://github.com/adbertram/git-pull-requests.git

التزام ودفع الملفات المحلية

بمجرد أن تكون قد استنسخت مستودع Git ، حان الوقت لتغيير الملف والتزام تلك التغييرات بالمستودع. للقيام بذلك:

1. افتح محرر الشفرة المفضل لديك ، وقم بتحرير وحفظ النص البرمجي C:\SampleText.ps1.

2. في نافذة الطرفية ، تأكد من أن دليل العمل الخاص بك هو C:\Git وقم بتشغيل الأمر أدناه. يقوم أمر الإضافة جيت بإضافة الملف إلى مستودع Git المحلي ولكنه لا يقوم بحفظه. إنه يبدأ فقط في تتبعه.

cd C:\Git
 git add SampleText.ps1

3. بعد ذلك ، قم بالتزام أو حفظ جميع الملفات التي تم تتبعها في مستودع Git باستخدام أمر git commit. تأكد أيضًا من تضمين شرح لما تم تغييره (رسالة التزام) باستخدام المعلمة -m.

git commit -m "modified sampletext file"

4. الآن بمجرد أن يحتوي مستودع Git المحلي على الملف المغير، قم بدفع تلك التغييرات إلى مستودع GitHub باستخدام gأمر it push. يجب أن تتلقى صندوقًا يطلب منك توفير اسم مستخدمك وكلمة مرورك للمصادقة على مستودع GitHub الخاص بك.

git push

5. بمجرد توفير اسم مستخدم GitHub وكلمة المرور الخاصة بك ، يجب أن ترى جيت تقدم بعض المعلومات عن الحالة مثلما هو موضح أدناه.

تقديم طلب سحب

في هذا الوقت، لديك نسخة الآن من مستودع GitHub الذي تود المساهمة فيه (منسوخ) في حساب GitHub الخاص بك مع التغيير الذي ترغب في طلبه إلى مستودع GitHub الأصلي. حان الآن وقت تقديم طلب السحب لطلب من مالك المستودع قبول تغييرك.

1. انتقل إلى مستودعك المنسوخ على GitHub.

2. انقر فوق طلبات السحب و طلب سحب جديد كما هو موضح أدناه.

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

4. قدم عنوانًا لطلب السحب وانقر على إنشاء طلب سحب.

ثم سترى على مستودع GitHub الأصلي، سيظهر طلب سحب. في هذا الوقت، انتهت مهمتك وحان وقت الانتظار للمالك.

مراجعة وقبول طلب السحب

فور إنشاء طلب السحب، سيظهر تحت طلب السحب تحت مستودع GitHub الأصلي كما هو موضح أدناه.

في هذا الوقت، سيقوم المالك إما بتقديم تعليقات لك حيث يمكنك التعاون في طلب السحب. أو يمكنهم ببساطة دمجه على الفور عن طريق النقر على دمج طلب السحب.

عندما يقومون بدمج طلب السحب مع الشيفرة الأصلية، سيذهب طلب السحب إلى حالة تم الدمج وستتم دمج الشيفرة مع المستودع الأصلي!

الآن، يمكنك رؤية أنك مساهم في الملف الذي قمت بتغييره وتم دمجه.

الختام

في هذا البرنامج التعليمي، تعلمت كل خطوة على كيفية إنشاء طلب استحضار Git. طلبات الاستحضار هي وسيلة رائعة للتعاون على مستودعات GitHub.

الآن بعد أن تعرفت على كيفية المساهمة في مشاريع GitHub، ما هو المستودع التالي الذي ستساهم فيه؟