البدء
تعلم اتفاقية الالتزام لدينا
2 min read
•259 wordsنحب أن تكون لدينا تاريخ مشروع نظيف. يعتمد تقليد الالتزامات لدينا على Conventional Commits ولكنه مُخصص باستخدام gitmoji ليكون أكثر بصرية ومرحًا.
الهيكل
يجب أن تكون رسالة الالتزام منظمة على النحو التالي وبالحروف الصغيرة:
<gitmoji> <type> <description> [(#<issue number>)]
[optional body]
[optional footer(s)]
مثال
📝 تحديث مساهمات الوثائق
- إضافة @jerembdn كمساهم
- إضافة @younesbessa كمساهم
Co-authored-by: Younes Bessa <[email protected]>
معظم الوقت، سطر واحد بسيط يكفي:
📝 تحديث مساهمات الوثائق
الأنواع
نستخدم الأنواع التالية من الالتزامات:
| النوع | الوصف |
|---|---|
add | إضافة ميزة جديدة |
fix | إصلاح خطأ |
improve | تحسين شيء ما |
update | تحديث شيء ما |
remove | إزالة شيء ما |
refactor | إعادة هيكلة شيء ما |
rename | إعادة تسمية شيء ما |
move | نقل ملف أو مجلد |
upgrade | ترقية التبعيات |
downgrade | خفض التبعيات |
الوصف
اكتب الأوصاف في أسلوب الأمر وبالخروف الصغيرة:
# جيد
📝 تحديث مساهمات الوثائق
# سيئ
📝 تم تحديث مساهمات الوثائق
# سيئ
📝 تحديث مساهمات الوثائق
رقم القضية
اربط الالتزامات بالقضايا عن طريق إضافة رقم القضية:
📝 تحديث مساهمات الوثائق (#123)
الجسم
استخدم الجسم للسياق والدافع:
📝 تحديث مساهمات الوثائق
- إضافة @jerembdn كمساهم
- إضافة @younesbessa كمساهم
Co-authored-by: Younes Bessa <[email protected]>
التزام واحد، غرض واحد
يجب أن يمثل كل التزام تغيير منطقي واحد. لا تخلط بين التغييرات غير المرتبطة.
Last updated on 01/14/2026