7.6 KiB
title | localeTitle |
---|---|
How to Make a Pull Request on Free Code Camp | كيفية عمل طلب سحب على Free Code Camp |
سحب رمز مخيم طلب
ما هو طلب السحب؟
طلب السحب (PR) هو طريقة لتقديم التغييرات المقترحة على Free Code Camp Repo (أو أي Repo ، لهذه المسألة). ستقوم بإجراء تغييرات على نسخ الملفات التي تشكل Free Code Camp في شوكة شخصية ، ثم تقدم بطلب للحصول عليها من قبل Free Code Camp.
تحتاج مساعدة؟
Free Code Camp Issue Mods والموظفون متواجدون لمساعدتك في حل مشكلات الطلب Pull في غرفة المحادثة للمساهمين.
أساليب
هناك طريقتان لإنشاء Pull for Free Code Camp:
- تحرير الملفات عبر واجهة GitHub
- تحرير الملفات على نسخة محلية
هام: تعديل دائمًا على فرع
لنأخذ شيئًا واحدًا فقط من هذا المستند ، يجب أن يكون هذا: لا تُجري أبدًا تعديلات على الفرع staging
. دائما جعل فرع جديد قبل تحرير الملفات. هذا أمر بالغ الأهمية ، لأنه إذا لم يتم قبول PR الخاص بك ، سيتم طبع نسخة staging
الخاص بك إلى الأبد والطريقة الوحيدة لإصلاحها هي حذف شوكتك وإعادة شوكة.
التعديل عبر Local Fork (مستحسن)
هذا هو الأسلوب الموصى بها. اقرأ حول كيفية الإعداد والمحافظة على مثيل محلي من Free Code Camp .
- نفذ خطوة صيانة rebasing
staging
- تأكد من وجودك على فرع
staging
باستخدامgit status
:
`
$ git
على فرع التدريج
الفرع الخاص بك مُحدّث مع "الأصل / التدريج".
لا شيء لارتكاب ، دليل العمل نظيفة
`
- إذا لم تكن على التدريج أو كان دليل عملك غير نظيف ، قم بحل أي ملفات / احتفالات معلقة وتسجيل الخروج
git checkout staging
- إنشاء فرع خارج
staging
مع git:git checkout -B branch/name-here
ملاحظة: تسمية الفرع مهمة. استخدم اسمًا مثلfix/short-fix-description
أوfeature/short-feature-description
راجع إرشادات المساهمة للحصول على مزيد من التفاصيل. - قم بتحرير الملف (الملفات) محليًا باستخدام محرر من اختيارك
- تحقق من
git status
الخاص بك لرؤية الملفات غير النظامية. - إضافة ملفاتك المعدلة:
git add path/to/filename.ext
يمكنك أيضا القيام بما يلي:git add .
لإضافة جميع الملفات غير الثابتة. ومع ذلك ، كن حريصًا ، لأنه يمكنك إضافة الملفات التي لا ترغب في إضافتها. مراجعةgit status
الخاصة بك أولاً. - قم
git commit -m "Brief Description of Commit"
تعديلاتك:git commit -m "Brief Description of Commit"
- اسحق التزاماتك ، إذا كان هناك أكثر من واحد.
- ادفع التزاماتك إلى GitHub Fork:
git push -u origin branch/name-here
- اذهب إلى الخطوات الشائعة
التحرير عبر واجهة GitHub
ملاحظة: لا ينصح بالتحرير عبر واجهة GitHub ، نظرًا لأنه من غير الممكن تحديث شوكتك عبر واجهة GitHub دون حذف وإعادة إنشاء شوكة.
- إنشاء شوكة FCC Repo
- إنشاء فرع داخل شوكة الخاص بك. ملاحظة: تسمية الفرع مهمة. استخدم اسمًا مثل
fix/short-fix-description
أوfeature/short-feature-description
راجع إرشادات المساهمة للحصول على مزيد من التفاصيل. - قم بتحرير الملف وارتكب التغييرات.
- الاستمرار في الخطوات الشائعة.
خطوات مشتركة
- بمجرد أن يتم تنفيذ التعديلات ، ستتم مطالبتك بإنشاء طلب سحب على صفحة Github الخاصة بـ.
- بشكل افتراضي ، يجب أن تكون جميع طلبات السحب ضد الريبو الرئيسي FCC ، الفرع
staging
. - اكتب عنوانًا واضحًا للعلاقات العامة الخاصة بك والتي تشير بإيجاز إلى ما يتم إصلاحه. لا تضيف رقم الإصدار في العنوان. أمثلة:
Add Test Cases to Algorithm Drop It
Correct typo in Challenge Size Your Images
- في نصوص العلاقات العامة الخاصة بك ، قم بتضمين ملخص أكثر تفصيلاً للتغيرات التي قمت بها ولماذا.
- حدد ما إذا كنت قد اختبرت على نسخة محلية من الموقع أم لا.
- إذا كان السبب في
Closes #xxxx
العامة هو مشكلة ، فيمكنك الإشارة إلى هذه المشكلةCloses #xxxx
تلقائيًا عن طريق إضافة كلمة رئيسية مثلCloses #xxxx
، حيث يمثلxxxx
رقم المشكلة.
الخطوات التالية
إذا تم طلب التغييرات
لا داعي للقلق ، فالكثير من المستفيدين الرئيسيين ، خاصةً المستفيدون الرئيسيون الأولون ، يحتاجون إلى التصحيح أو التحديث. إذا كنت قد استخدمت واجهة GitHub لإنشاء العلاقات العامة ، فستحتاج إلى إغلاق العلاقات العامة وإنشاء فرع جديد وإعادة الإرسال. هذا لأنك لا تستطيع التخلص من التزاماتك عبر واجهة GitHub.
إذا كان لديك نسخة محلية من الريبو ، فيمكنك إجراء التغييرات المطلوبة وتعديل الالتزام الخاص بك: git commit --amend
سيؤدي هذا إلى تحديث git commit --amend
الحالي. عندما git push --force
على شوكة الخاص بك سوف تحتاج إلى القيام بدفع القوة git push --force
الالتزام القديم: git push --force
تأكد من النشر في محادثة العلاقات العامة أنك قمت بإجراء التغييرات المطلوبة.
إذا تم قبول PR الخاص بك
بمجرد قبول العلاقات العامة ، يمكنك حذف الفرع الذي أنشأته لإرساله. هذا يحافظ على عمل شوكة نظيفة. يمكنك القيام بذلك بضغطة زر على واجهة GitHub PR. يمكنك حذف النسخة المحلية للفرع مع: git branch -D branch/to-delete-name
إذا تم رفض PR الخاص بك
لا تيأس! يجب أن تتلقى تعليقات صلبة من المشرفين على القضايا لماذا تم رفضها وما هو مطلوب. من فضلك ، استمر في المساهمة.