لاگ کوتاه

استفاده

git shortlog [گزینه‌ها]

مثال‌ها

git shortlog                # نمایش خلاصه‌ای از commit‌ها بر اساس نویسنده
git shortlog -n             # مرتب‌سازی بر اساس تعداد commit‌ها
git shortlog -e             # نمایش آدرس ایمیل نویسندگان
git shortlog --since=<تاریخ> # نمایش commit‌ها از تاریخ مشخص

دقیقاً چه می‌کند؟

دستور git shortlog خلاصه‌ای از تاریخچه commit ها به تفکیک نویسنده ارائه می‌دهد. این ابزار به شما کمک می‌کند تا یک نمای کلی از مشارکت‌های افراد در پروژه و تاریخچه تغییرات داشته باشید. این دستور معمولاً برای تولید آمار و گزارش‌های مربوط به نویسندگان استفاده می‌شود.

موارد کاربرد رایج

• خلاصه‌سازی تاریخچه commit‌ها بر اساس نویسنده.
• تولید آمار از مشارکت‌کنندگان پروژه.
• یافتن اینکه چه کسی بیشترین commit‌ها را در یک بازه زمانی خاص انجام داده است.
• پیگیری تغییرات در یک پروژه توسط نویسندگان مختلف در طول زمان.

بهترین شیوه‌ها

• از -n برای مرتب‌سازی براساس تعداد commit‌ها استفاده کنید تا ببینید چه کسی بیشترین مشارکت را داشته است.
• اگر با تیمی کار می‌کنید، از -e برای نمایش آدرس ایمیل‌ها استفاده کنید تا شناسایی مشارکت‌کنندگان دقیق‌تر باشد.
• از --since برای فیلتر کردن commit ها بر اساس تاریخ استفاده کنید، این امر برای تولید گزارش‌های هفتگی یا ماهانه مفید است.

محدودیت‌ها

• فقط تاریخچه commit ها را خلاصه می‌کند و اطلاعات مربوط به جزئیات commit مانند پیام‌ها یا diffs را نشان نمی‌دهد.
• اگر به دنبال جزئیات دقیق commit‌ها هستید، باید از git log استفاده کنید.
• دستور git shortlog فقط نویسندگانی را نشان می‌دهد که commit انجام داده‌اند و ممکن است نویسندگان بدون commit را نشان ندهد.

اشتباهات رایج

• فراموش کردن استفاده از -n برای مرتب‌سازی بر اساس تعداد commit‌ها، که ممکن است خروجی نامرتب شود.
• استفاده از آن بدون فیلتر کردن تاریخ (مثلاً --since) زمانی که نیاز به گزارش در بازه زمانی خاص دارید.
• عدم توجه به اینکه آدرس‌های ایمیل ممکن است در صورتی که نویسندگان فرمت ایمیل ثابت نداشته باشند، در دسترس نباشند.

نمای کلی

دستور git shortlog ابزاری مفید برای خلاصه‌سازی تاریخچه commit ها بر اساس نویسنده است. این ابزار معمولاً برای تولید آمار و گزارش‌هایی در مورد مشارکت‌ها و تغییرات در پروژه استفاده می‌شود. با این حال، این دستور بیشتر برای خلاصه‌های سطح بالا مفید است و برای جستجو در جزئیات commit ها مناسب نیست.

مقایسه با روش‌های دیگر