freeCodeCamp/guide/arabic/miscellaneous/writing-good-git-commit-mes.../index.md

2.2 KiB

title localeTitle
Writing Good Git Commit Messages كتابة رسائل 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