Frontend Academy · درس

سير عمل Pull Request على GitHub

افتح Pull Request على GitHub، واكتب وصفًا مفيدًا، وردّ على تعليقات مراجعة الشيفرة، وادمجه بعد الموافقة.

سير عمل Pull Request على GitHub درس مجاني في Frontend Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Frontend Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Frontend Academy 4 دروس في المجموع.

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

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

إنشاء PR على GitHub

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

كتابة وصف جيد لـPR

يوضح وصف PR الجيد: ما الذي تغيّر ولماذا. أدرج لقطة شاشة عند إجراء تغييرات على واجهة المستخدم. واربط المشكلة ذات الصلة. وصِف كيفية اختبار التغيير. ينبغي ألا يحتاج القارئ إلى قراءة الشيفرة لفهم الهدف.

## Summary
Adds dark mode support using CSS custom properties.

## Why
Users requested dark mode (#123). Reduces eye strain for evening use.

## Testing
- Toggled dark/light mode on macOS and Windows
- Verified `prefers-color-scheme: dark` auto-triggers
- Tested with a screen reader (macOS VoiceOver)

طلب المراجعين

عيّن أعضاء محددين من الفريق كمراجعين. سيتلقون إشعارًا ويمكنهم الموافقة أو طلب التغييرات أو إضافة تعليق. تتطلب معظم الفرق موافقة واحدة على الأقل قبل الدمج.

قراءة تعليقات مراجعة الشيفرة

تظهر التعليقات ضمنيًا بجوار الأسطر التي تغيّرت. ويمكن للمراجعين طلب توضيح أو اقتراح نهج مختلف أو الموافقة. أجب عن كل تعليق، إما بإجراء تغيير في الشيفرة أو بذكر سبب عدم إجرائه.

الاستجابة للتغييرات المطلوبة

عندما يطلب أحد المراجعين تغييرات، ادفع commits جديدة إلى الفرع نفسه. سيتحدث PR تلقائيًا. احسم كل محادثة بالنقر على «حل المحادثة» بعد معالجة ملاحظتها.

مسودات PR

افتح PR بوصفه مسودة للإشارة إلى أنه عمل جارٍ. تسمح مسودات PR بالمراجعة والنقاش، لكنها لا تسمح بالدمج غير المقصود. حوّله إلى جاهز عند اكتماله.

الحفاظ على حداثة فرعك

عندما يتقدم main أثناء المراجعة، أعد تطبيق فرعك فوق أحدث main لتجنب التعارضات وضمان توافق تغييراتك مع الشيفرة الجديدة.

git fetch origin
git rebase origin/main
git push --force-with-lease origin feature/dark-mode

Squash Merge مقابل Merge Commit مقابل Rebase

يوفر GitHub ثلاث استراتيجيات للدمج: Merge commit (يحافظ على جميع commits)، وSquash and merge (commit واحد لكل PR مع سجل نظيف لـmain)، وRebase and merge (سجل خطي دون commit دمج). تختار الفرق عادةً استراتيجية واحدة للاتساق.

قواعد حماية الفروع

احمِ main بفرض مراجعة PR، واشتراط نجاح فحوصات الحالة (CI)، ومنع عمليات الدفع المباشرة. اضبط ذلك من GitHub ← الإعدادات ← الفروع.

آداب التعامل مع PR

اجعل PRs صغيرة ومركزة. أنشئ PR واحدًا لكل ميزة أو إصلاح. يصعب مراجعة PRs الكبيرة. أجب عن تعليقات المراجعة خلال يوم. اشكر المراجعين. وتحلَّ باللطف، فمراجعة الشيفرة فرصة للتعلّم وليست تدقيقًا.

تحقق سريع

ما الذي ينبغي أن يتضمنه وصف PR الجيد؟

مراجعة: سير عمل طلب السحب

ادفع فرع الميزة ← افتح PR بوصف واضح ← اطلب مراجعين ← عالج الملاحظات باستخدام commits جديدة ← حافظ على حداثة الفرع عبر rebase ← احصل على الموافقة ← ادمج. اجعل PRs صغيرة ومركزة وموصوفة جيدًا. تفرض قواعد حماية الفروع الجودة على main.

الأسئلة الشائعة

هل درس «سير عمل Pull Request على GitHub» مجاني؟

نعم — نص درس «سير عمل Pull Request على GitHub» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Frontend Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Frontend Academy 4 دروس في المجموع.

ماذا ستتعلم في «سير عمل Pull Request على GitHub»؟

افتح Pull Request على GitHub، واكتب وصفًا مفيدًا، وردّ على تعليقات مراجعة الشيفرة، وادمجه بعد الموافقة. تتمرن على Frontend Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Frontend Academy؟

لا تُشترط خبرة سابقة. Frontend Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «سير عمل Pull Request على GitHub»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Frontend Academy هذا؟

نعم. كل درس في Frontend Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Frontend Academy