فتح PR ووصفه

كتبت التغيير، وشغّلت الاختبارات، وتبدو الـ diff نظيفة. الآن عليك فتح PR — لكن عنوانًا من سطر واحد مثل "fix bug" يترك المراجع بلا شيء ينطلق منه. وصف PR الجيد لا يكرر ما تُظهره الـ diff بالفعل — بل يشرح السبب: ما الذي أدى إلى التغيير، وكيف يُتحقق من أنه يعمل، وما هي المخاطرة. وعندما يكون للمستودع قالب

الوصف الجيد يشبه ملاحظة تتركها لجليسة الأطفال: كتابة 'راقبي الطفل' لا تكفي — عليك أن تشرح لماذا يختلف روتين هذه الليلة وكيف تتحقق أن كل شيء على ما يرام قبل النوم.

وصف PR (PR description): النص المرافق لـ Pull Request الذي يشرح للمراجع لماذا أُجري التغيير، وكيف يُختبر، وما هي المخاطرة — وليس مجرد إعادة صياغة لما تُظهره الـ diff بالفعل.
قالب PR (PR template): ملف ثابت في المستودع (مثل .github/pull_request_template.md) يحدد الأقسام التي يجب أن تظهر في كل وصف PR، بحيث يملأ الجميع المعلومات نفسها.
PR بحالة مسودة (draft PR): PR يُفتح في حالة مسودة — مرئي للفريق ويُشغّل الفحوصات، لكنه لا يشير إلى 'جاهز للمراجعة الكاملة' حتى يُوسم بـ Ready for review.
جاهز للمراجعة (Ready for review): الإجراء الذي يحوّل PR من مسودة إلى حالة تطلب فعليًا انتباه المراجع الكامل — الإشارة إلى أن العمل جاهز، لا مجرد مرئي.