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) |