NahdaAIنهضة
Git & GitHub • المستوى الثالث • الدرس 3

طلبات السحب والمراجعة الجماعية (Pull Requests & Code Review)

العودة لفهرس المستوى

أهداف الدرس

  • فهم دور طلبات السحب Pull Requests (PRs) في ضبط جودة المشاريع.
  • مراجعة الشيفرات (Code Review) مع الفريق واكتشاف الأخطاء قبل الدمج.
  • إنشاء فرع احترافي بتسمية معيارية ورفعه إلى GitHub.
  • تنظيف الفروع المحلية بعد إتمام عملية الدمج بنجاح.

1. ما هو طلب السحب Pull Request؟

هو آليّة تسمح لك بطلب إدراج كودك من فرع معين إلى الفرع الرئيسي للمشروع. يُتيح للمشرفين فحص التغييرات، إضافة ملاحظات، واختبار الكود قبل الدمج النهائي.

bash
# دورة حياة Pull Request الكاملة

# 1. إنشاء فرع للميزة الجديدة
git checkout -b feature/add-dark-mode

# 2. الالتزام ورفع الفرع إلى GitHub
git add .
git commit -m "feat: add dark mode toggle"
git push -u origin feature/add-dark-mode

# 3. على GitHub -> اضغط "Compare & pull request"
#    املأ العنوان والوصف، ثم اطلب مراجعة الفريق

# 4. بعد الموافقة -> اضغط "Merge pull request"

# 5. تنظيف محلي
git checkout main
git pull origin main
git branch -d feature/add-dark-mode

2. خطوات فتح Pull Request على GitHub

1. رفع الفرع

بعد رفع الفرع عبر git push، ستظهر لك GitHub زر "Compare & pull request" على الصفحة الرئيسية.

2. وصف PR

اكتب عنواناً واضحاً ووصفاً لما تم إنجازه، وأضف قائمة بالمهام المنجزة (Checklist).

3. مراجعة الفريق

يُراجع الزملاء الكود، يضيفون تعليقات، ويطلبون تعديلات إن لزم. العملية تُسمى Code Review.

4. الدمج

بعد الموافقة، يضغط المشرف "Merge pull request" ليُدمج الكود في الفرع الرئيسي.

3. فوائد Pull Requests و Code Review

اكتشاف الأخطاء

مراجعة ثانية قبل الدمج تكتشف الأخطاء مبكراً.

نقل المعرفة

الفريق يتعلم من بعضه البعض عبر التعليقات.

توثيق تاريخي

لكل ميزة سجل واضح مع مناقشاتها.

التطبيق العملي المباشر

تحدي الدرس الثالث: دورة عمل Pull Request كاملة

قم بالتعديل على الكود بداخل المحرر أدناه لتطبيق المتطلبات التالية:

  1. أعدّ المستودع المحلي مع أول التزام، اربطه بـ GitHub بـ git remote add.
  2. ارفع الفرع الرئيسي أولاً بـ git push -u origin main.
  3. أنشئ فرعاً جديداً باسم feature/add-dark-mode بـ git checkout -b.
  4. أنشئ التزاماً برسالة معيارية feat: add dark mode toggle.
  5. ارفع الفرع الجديد بـ git push -u origin feature/add-dark-mode — هذه هي الخطوة التي تُفعّل Pull Request على GitHub.
  6. عرض الفروع المحلية والبعيدة بـ git branch -a.
  7. عُد إلى main بـ git checkout main، ثم نظّف الفرع بـ git branch -d feature/add-dark-mode.
⏳ جارٍ تحميل المحرر التفاعلي...
الدرس السابقالانتقال للدرس الرابع