حلقات المراجعة
المسار: الكتابة باللمس وإنتاجية المبرمج الوحدة: الإنتاجية للمبرمج
مدخل إلى الدرس: حلقات المراجعة
في هذا الدرس من مسار الكتابة والإنتاجية على أديب الصلوي: راجع كودك قبل الطلب: diff ذاتي، checklist، ثم اطلب مراجعة زميل.…
طريقة الدراسة: اقرأ التعريف، تتبّع المثال في الشرح، نفّذه بنفسك، ثم اختبر النتيجة والحالات الاستثنائية قبل الانتقال.
مقدمة الدرس
راجع كودك قبل الطلب: diff ذاتي، checklist، ثم اطلب مراجعة زميل.
self-review
اقرأ diff سطراً سطراً كما لو كنت مراجعاً.
- شغّل tests محلياً.
- احذف console.log قبل push.
التعلم
ملاحظات المراجعة تدخل قائمة عادات الكتابة.
أخطاء شائعة
- push مباشرة بعد الكتابة.
- تجاهل تعليقات المراجعة.
- مراجعة شكلية بدون تشغيل tests.
تمرين تطبيقي: بعد تعديل ملف واحد، نفّذ self-review 10 دقائق واكتب ملاحظتين لنفسك.
معجم المصطلحات
- المراجعة
- Code review cycle.
- Checklist
- Pre-push quality list.
هذا الدرس ضمن مسار الكتابة باللمس وإنتاجية المبرمج على منصة أديب الصلوي (Adeeb Al-Silwy).
مثال عملي للتطبيق
الموقف: نعمل على برنامج صغير لحل مشكلة يومية مع مدخلات ونتائج يمكن التحقق منها. نحتاج إلى توظيف فكرة حلقات المراجعة لتلبية مطلب محدد يمكن قياس نجاحه.
- حدد البيانات أو المكونات ذات العلاقة في المثال.
- طبّق خطوات الموضوع على نسخة تجريبية بسيطة، ودوّن الناتج المتوقع قبل التنفيذ.
- جرّب حالة صحيحة وحالة خاطئة، وقارن النتيجة بالسلوك المتوقع.
معيار النجاح: تستطيع تفسير السبب وراء كل خطوة وإعادة تنفيذ المثال دون الرجوع إلى الحل.
مراجعة وتمرين تثبيت المهارة
اختبار سريع: اشرح بعبارتك معنى «حلقات المراجعة»، ثم بيّن أين ستستخدمه داخل برنامج صغير لحل مشكلة يومية مع مدخلات ونتائج يمكن التحقق منها، وما الخطأ الذي يجب اختباره قبل الاعتماد على الحل.
تحدٍّ إضافي: غيّر شرطًا واحدًا في التطبيق، وتوقع النتيجة، ثم نفّذ الاختبار وفسّر الاختلاف.
