لینک کوتاه مطلب : https://hsgar.com/?p=6044

commit پیام‌ها مهم نیست

فرآیند نوشتن پیام های commit “خوب” برای برخی از توسعه دهندگان مقدس است. با یک جستجوی سریع، ده ها مقاله در مورد “چگونه پیام های تعهدی خوب بنویسیم” ظاهر می شود. استایل مناسب؟ قالب بندی. صدای ضروری حروف بزرگ. بسته بندی های سخت

پیام های متعهد مهم نیست.

پیام‌های تعهد احتمالاً یکی از بدترین مکان‌ها برای مستندسازی و منبع متداول دوچرخه‌سواری هستند.

افزودن اطلاعات در مورد چه فایل هایی تغییر کرده اند معنی ندارد – این اطلاعات با نگاه کردن به آن راحت تر ذخیره می شود diff (یا ایندکس شده توسط فایل با blame).

اطلاعاتی درباره چرا و چگونه اغلب خانه های بهتری دارند تاریخچه بررسی کد، ردیاب اشکال، نظرات کد و مستندات واقعی وجود دارد. همه آنها احتمالاً مکان های بهتری برای ذخیره دانش واقعی هستند1.

مقالات پیام commit شما احتمالاً به هر حال از بین می‌روند یا از بین می‌روند – له می‌شوند، ادغام می‌شوند، یا تغییر می‌کنند.

من به Commit Message Writers یک استراحت می دهم. اگر از فراداده پیام برای راه‌اندازی جریان کاری مبتنی بر رویداد استفاده می‌کنید، به‌طور خودکار یک باگ را ببندید یا به یک شی خارج از git ارجاع دهید. مطمئناً، مهاجرت دردناک خواهد بود، اما اگر ابرداده شما آنقدر ارزشمند باشد، راهی برای انتقال آن پیدا خواهید کرد.

لینک منبع

ارسال یک پاسخ

آدرس ایمیل شما منتشر نخواهد شد.