34 lines
2.2 KiB
Markdown
34 lines
2.2 KiB
Markdown
|
---
|
|||
|
|
title: Writing Good Git Commit Messages
|
|||
|
|
localeTitle: كتابة رسائل Git Commit الجيدة
|
|||
|
|
---
|
|||
|
|
1. موضوع منفصل من الجسم مع خط فارغ
|
|||
|
|
2. حدد سطر الموضوع إلى 50 حرفًا
|
|||
|
|
3. تكبير خط الموضوع
|
|||
|
|
4. لا تنهي سطر الموضوع بنقطة
|
|||
|
|
5. استخدام المزاجية الحتمية في سطر الموضوع
|
|||
|
|
6. التفاف الجسم في 72 حرفا
|
|||
|
|
7. استخدم الجسد لشرح ماذا ولماذا في مقابل ذلك
|
|||
|
|
|
|||
|
|
**يجب أن يكون سطر موضوع الالتزام باستخدام git بشكل صحيح قادراً على إكمال الجملة التالية:**
|
|||
|
|
|
|||
|
|
> إذا تم تطبيقه ، فإن هذا الالتزام سيصبح _`<<your subject line here>>`_
|
|||
|
|
|
|||
|
|
**فمثلا:**
|
|||
|
|
|
|||
|
|
* إذا تم تطبيقه ، فإن هذا الالتزام سوف يعمل على **_إعادة ضبط النظام الفرعي X لسهولة القراءة_**
|
|||
|
|
* إذا تم تطبيقه ، فسيؤدي هذا الالتزام إلى **_تحديث وثائق البدء_**
|
|||
|
|
* إذا تم تطبيقه ، فسيؤدي هذا الالتزام إلى **_إزالة طرق موقوفة_**
|
|||
|
|
* إذا تم تطبيقه ، فإن هذا الالتزام سيطلق **_الإصدار 1.0.0_**
|
|||
|
|
* إذا تم تطبيقه ، فسيتم **_دمج_** هذا الالتزام **_لطلب السحب رقم 123 من المستخدم / الفرع_**
|
|||
|
|
|
|||
|
|
**لاحظ كيف لا يعمل ذلك مع الأشكال الأخرى غير الضرورية:**
|
|||
|
|
|
|||
|
|
* إذا تم تطبيقه ، فسيتم _إصلاح_ هذا الالتزام _مع الخطأ Y_
|
|||
|
|
* إذا تم تطبيقه ، فإن هذا الالتزام سيؤدي إلى _تغيير سلوك X_
|
|||
|
|
* إذا تم تطبيقه ، فسيعمل هذا الالتزام بشكل _أكبر على إصلاح الأشياء المكسورة_
|
|||
|
|
* إذا تم تطبيقه ، فسيؤدي هذا الالتزام إلى _طرق API الجديدة الحلوة_
|
|||
|
|
|
|||
|
|
**تذكر:** _استخدام الأمر أمر مهم فقط في سطر الموضوع. يمكنك تخفيف هذا القيد عندما تكتب الجسد._
|
|||
|
|
|
|||
|
|
**المرجع:** [http://chris.beams.io/posts/git-commit](http://chris.beams.io/posts/git-commit)
|