چینج لاگ (Changelog) جنریٹر

Git کمٹ ہسٹری سے Keep a Changelog معیار کے مطابق پیشہ ورانہ چینج لاگ تیار کریں۔

Parsed 0 Conventional Commits

چینج لاگ (Changelog) جنریٹر کے بارے میں — تفصیلی رہنما

زمرہ: DevOps اور معیارات 100% براؤزر میں مقامی

Changelog Generator خام Git کمٹ لاگز کو پارس کرتا ہے اور انہیں معیاری، ریلیز کے لیے تیار `CHANGELOG.md` دستاویزات میں فارمیٹ کرتا ہے۔ یہ Conventional Commits کے نحو (syntax) کے ساتھ ساتھ معیاری کمٹ پیغامات کو بھی سمجھتا ہے۔

کمٹس کو منظم زمروں میں تقسیم کیا جاتا ہے: Features، Bug Fixes، Performance Improvements، Documentation، اور Refactoring۔ سنگل کلک Markdown ایکسپورٹ کے لیے مرج کمٹس کو فلٹر کرتے ہوئے ریلیز ورژن ٹیگز اور تاریخیں ترتیب دیں۔

#changelog #git #release #version #history

اہم خصوصیات اور صلاحیتیں

  • مقامی `git log --oneline` ٹرمینل کمانڈز کے آؤٹ پٹ کو براہ راست پارس کرتا ہے
  • Conventional Commit کی اقسام (feat، fix، perf، docs) کے ذریعے کمٹ اندراجات کی خودکار درجہ بندی کرتا ہے
  • Keep a Changelog کے معیارات کے مطابق قابلِ ترتیب ریلیز ورژن ٹیگ اور تاریخ کے بینرز
  • غیر ضروری مرج کمٹس کو فلٹر کرتا ہے اور صاف ستھرا، کاپی پیسٹ کے قابل Markdown فراہم کرتا ہے

استعمال کرنے کا طریقہ

  1. 1

    اپنے ریپوزٹری ٹرمینل میں `git log --oneline` چلائیں اور لاگز کو ان پٹ فیلڈ میں پیسٹ کریں۔

  2. 2

    اپنا مطلوبہ ریلیز ورژن درج کریں (مثلاً `v1.2.0`) اور ریلیز کی تاریخ منتخب کریں۔

  3. 3

    درجہ بند ریلیز نوٹس کا جائزہ لیں اور Copy پر کلک کریں یا `CHANGELOG.md` ڈاؤن لوڈ کریں۔

عام استعمال کی صورتیں

  • ← پروڈکشن اپ ڈیٹس تعینات کرنے سے پہلے GitHub Releases کے لیے ریلیز نوٹس تیار کرنا
  • ← اوپن سورس ریپوزٹریز کے لیے ایک مرکزی، تاریخی CHANGELOG.md فائل کو برقرار رکھنا
  • ← پروڈکٹ اسٹیک ہولڈرز کے لیے پیچیدہ تکنیکی کمٹس کو پڑھنے کے قابل چینج لاگز میں تبدیل کرنا

متعلقہ ٹولز

اکثر پوچھے گئے سوالات اور رازداری

میں پچھلے ریلیز ٹیگ کے بعد کے کمٹس کیسے نکال سکتا ہوں؟

پچھلی ریلیز کے بعد کیے گئے کمٹس کو الگ کرنے کے لیے اپنے ٹرمینل میں `git log <previous-tag>..HEAD --oneline` چلائیں۔

غیر روایتی (non-conventional) کمٹس کی درجہ بندی کیسے کی جاتی ہے؟

روایتی سابقوں سے محروم کمٹس کو "Other Changes" کے سیکشن کے تحت گروپ کیا جاتا ہے، جس سے یقینی بنتا ہے کہ کوئی بھی کمٹ چھوٹ نہ جائے۔