Conventional Commits معاون

معیاری اصولوں کے مطابق پیشہ ورانہ اور منظم Git کمٹ پیغامات تیار کریں۔

0/72

Fill in the description to preview the commit message

Conventional Commits format

<type>[scope]: <description>

[optional body]

[optional footer(s)]

Common examples

Conventional Commits معاون کے بارے میں — تفصیلی رہنما

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

Conventional Commit Generator اسٹرکچرڈ Git کمٹ پیغامات تیار کرتا ہے جو Conventional Commits تصریح کی پابندی کرتے ہیں۔ یہ Type، Scope، Subject لائن، اختیاری Body تفصیل اور Footer ایشوز کو منتخب کرنے میں ڈیولپرز کی رہنمائی کرتا ہے۔

فجائیہ سنٹیکس (`type!: description`) کے ذریعے بریکنگ تبدیلیوں کو آسانی سے نشان زد کریں، حل شدہ مسائل کا حوالہ دیں (`Closes #123`)، اور معیاری کمٹ پیغامات حاصل کریں جو `semantic-release` اور خودکار changelog جنریٹرز جیسے ٹولز کو فعال بناتے ہیں۔

#git #commit #conventional #message #changelog

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

  • مکمل اقسام کا کیٹلاگ: feat، fix، docs، style، refactor، perf، test، build، ci، chore، revert
  • اختیاری اسکوپ ان پٹ اور ریئل ٹائم سبجیکٹ کی لمبائی / امرائی جملے (imperative phrasing) کے یاد دہانی والے اشارے
  • معیاری فجائیہ نشان (`!`) کے سنٹیکس کا اطلاق کرنے والا ون کلک Breaking Change ٹوگل
  • ون کلک `git commit -m` کاپی کے ساتھ ایشو لنکنگ کا خودکار فوٹر جنریٹر

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

  1. 1

    کمٹ کی قسم منتخب کریں (مثلاً فیچرز کے لیے `feat`، بگز کی درستی کے لیے `fix`)۔

  2. 2

    ایک اختیاری اسکوپ (مثلاً `api`، `auth`) اور ایک جامع امرائی تفصیل درج کریں۔

  3. 3

    مرتب شدہ کمٹ سٹرنگ کا جائزہ لیں اور اپنے ٹرمینل کے لیے مکمل `git commit` کمانڈ کاپی کریں۔

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

  • ← انجینئرنگ ٹیموں کو مستقل اور یکساں Git کمٹ ہسٹری کے معیارات سے ہم آہنگ کرنا
  • ← CI/CD پائپ لائنز کے ساتھ خودکار سیمنٹک ورژن بَمپس اور ریلیز نوٹس کو خودکار بنانا
  • ← بڑی لائبریری اپ ڈیٹس کے دوران غیر مطابقت پذیر (backward-incompatible) API بریکنگ تبدیلیوں کو نشان زد کرنا

متعلقہ ٹولز

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

ہر کمٹ کی قسم کس سیمنٹک ورژن بَمپ (bump) سے مطابقت رکھتی ہے؟

معیاری Conventional Commits روایات کے تحت، `fix` ایک PATCH بَمپ کو متحرک کرتا ہے، `feat` ایک MINOR بَمپ کو چلاتا ہے، اور `BREAKING CHANGE` پر مشتمل کوئی بھی کمٹ MAJOR بَمپ کا سبب بنتا ہے۔

کیا سبجیکٹ لائن کا اختتام فل اسٹاپ (ختمہ) پر ہونا چاہیے؟

نہیں، Conventional Commits کے بہترین طریقے آخر میں فل اسٹاپ کے بغیر ایک جامع امرائی جملے کی سفارش کرتے ہیں (مثلاً `feat: allow user avatar upload`)۔