رسائل الالتزام يجب أن تشرح لماذا وليس ماذا

المشكلة

رسائل مثل "إصلاح خطأ" أو "تحديث ملف" عديمة الفائدة بعد 6 أشهر عندما تحتاج فهم ما تغير ولماذا.

الحل

اكتب رسائل التزام تشرح سبب التغيير. الفرق يُظهر ما تغير — الرسالة يجب أن تشرح لماذا.

الفائدة

يجعل git blame و git log مفيدين فعلاً. فريقك (وأنت في المستقبل) سيشكرونك أثناء التصحيح.

مثال الكود

# رسائل التزام سيئة:
git commit -m "إصلاح خطأ"
git commit -m "تحديث الأنماط"
git commit -m "تغييرات"

# رسائل التزام جيدة:
git commit -m "منع الطلبات المكررة عند نقر المستخدم مرتين على إرسال"
git commit -m "زيادة المهلة إلى 30 ثانية — API بطيء في أوقات الذروة"
git commit -m "إزالة نقاط نهاية v1 المهملة قبل موعد مارس"