كيف تجري مراجعات كود فعالة واحترافية؟

Question

Accepted Answer

مراجعة الكود من أعلى الأنشطة التي تحقق نتائج للمدير الفني: فهي تحمي الجودة *و* تعلم الفريق. الهدف هو **كود أفضل وفريق أقوى**، وليس السيطرة على عملية الدمج. يجب أن تكون المراجعات سريعة وودية وركزة على ما يهم.

## المبادئ

```text
✓ Review the CODE, never the person ("this function" not "you")
✓ Distinguish must-fix from nice-to-have (label nits explicitly)
✓ Ask questions, don't issue commands ("what about X?" invites discussion)
✓ Praise good work, not just problems
✓ Be fast — a PR blocked for two days kills momentum
✓ Approve when it's good enough, not perfect
```

## مثال عملي

بدلاً من "هذا خطأ، استخدم map"، اكتب: "nit: استخدام map هنا سيتجنب الحلقة المتداخلة، هل يستحق؟ لا أعترض على الدمج." نفس النقطة، لكنها تعلم وتترك مجالاً للاختلاف ولا تعطل الدمج.

## راقب ديناميكية القوة

بصفتك مدير فني، تعليقاتك لها وزن إضافي. قول عارض "كنت سأفعلها بطريقة مختلفة" قد يبدو كأمر. كن صريحاً حول ما هو قلق حقيقي مقابل تفضيل، واترك للناس فرصة الاعتراض.

## لماذا هذا مهم

تحدد المراجعات معيار جودة الفريق وحالته العاطفية.

مراجعات قاسية تجعل الناس دفاعيين وبطيئين في النشر.

المراجعات الجيدة تكتشف الأخطاء وتنشر المعرفة وتجعل المهندسين أفضل، مع تأثير متراكم مع الوقت.