الدرس 14: الـVibe الاجتماعي: مراجعات الكود والتعاطف مع الفريق

لا يتعلق إحساس الكود بالكود فحسب؛ بل يتعلق بالثقافة المحيطة به. التفاعل أثناء مراجعات الكود (PRs أو Merge Requests) يحدد في الغالب الروح المعنوية للفريق والسلامة النفسية.

آداب مراجعة الكود (إرسال طلب السحب PR)

1. مجموعات تغيير صغيرة: حافظ على تركيز طلبات السحب على مهمة منطقية واحدة. طلبات السحب الكبيرة تسبب إرهاق المراجعة وتؤدي إلى فقدان الأخطاء.
2. وصف رائع: لخص السبب (المشكلة التي تم حلها)، و ما تم إجراؤه (التغييرات التي تمت)، و كيف (استراتيجية التنفيذ). قم بتضمين لقطات شاشة أو ملاحظات أداء إذا كانت ذات صلة.
3. المراجعة الذاتية: راجع الكود الخاص بك أولاً! أصلح الأخطاء الواضحة، وأزل التعليقات غير الضرورية، وتأكد من أن التنسيق متسق.

آداب مراجعة الكود (تلقي/تقديم التعليقات)

يجب أن تكون التعليقات بناءة ومُركّزة على الكود، وليس على الشخص.

• إحساس سيئ: 'هذا نهج فظيع. استخدم X بدلاً من ذلك.'
• إحساس جيد: 'أقترح النهج X هنا لأنه يتعامل مع الحالة الحدية Y بشكل أكثر قوة. ما هي أفكارك؟'

فحص الـVibe الرئيسي أثناء المراجعة

• إلزامي مقابل اقتراح: استخدم تسميات مثل nitpick: (إصلاح أسلوبي بسيط) أو blocking: (خلل منطقي حرج) لتوضيح الأهمية.
• توفير الحلول: لا تكتفِ بالإشارة إلى مشكلة؛ قدم مثالاً ملموساً أو حلاً.

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