Conventional Commits معاون کے بارے میں — تفصیلی رہنما
Conventional Commit Generator اسٹرکچرڈ Git کمٹ پیغامات تیار کرتا ہے جو Conventional Commits تصریح کی پابندی کرتے ہیں۔ یہ Type، Scope، Subject لائن، اختیاری Body تفصیل اور Footer ایشوز کو منتخب کرنے میں ڈیولپرز کی رہنمائی کرتا ہے۔
فجائیہ سنٹیکس (`type!: description`) کے ذریعے بریکنگ تبدیلیوں کو آسانی سے نشان زد کریں، حل شدہ مسائل کا حوالہ دیں (`Closes #123`)، اور معیاری کمٹ پیغامات حاصل کریں جو `semantic-release` اور خودکار changelog جنریٹرز جیسے ٹولز کو فعال بناتے ہیں۔
اہم خصوصیات اور صلاحیتیں
- مکمل اقسام کا کیٹلاگ: feat، fix، docs، style، refactor، perf، test، build، ci، chore، revert
- اختیاری اسکوپ ان پٹ اور ریئل ٹائم سبجیکٹ کی لمبائی / امرائی جملے (imperative phrasing) کے یاد دہانی والے اشارے
- معیاری فجائیہ نشان (`!`) کے سنٹیکس کا اطلاق کرنے والا ون کلک Breaking Change ٹوگل
- ون کلک `git commit -m` کاپی کے ساتھ ایشو لنکنگ کا خودکار فوٹر جنریٹر
استعمال کرنے کا طریقہ
- 1
کمٹ کی قسم منتخب کریں (مثلاً فیچرز کے لیے `feat`، بگز کی درستی کے لیے `fix`)۔
- 2
ایک اختیاری اسکوپ (مثلاً `api`، `auth`) اور ایک جامع امرائی تفصیل درج کریں۔
- 3
مرتب شدہ کمٹ سٹرنگ کا جائزہ لیں اور اپنے ٹرمینل کے لیے مکمل `git commit` کمانڈ کاپی کریں۔
عام استعمال کی صورتیں
- ← انجینئرنگ ٹیموں کو مستقل اور یکساں Git کمٹ ہسٹری کے معیارات سے ہم آہنگ کرنا
- ← CI/CD پائپ لائنز کے ساتھ خودکار سیمنٹک ورژن بَمپس اور ریلیز نوٹس کو خودکار بنانا
- ← بڑی لائبریری اپ ڈیٹس کے دوران غیر مطابقت پذیر (backward-incompatible) API بریکنگ تبدیلیوں کو نشان زد کرنا
متعلقہ ٹولز
HTML میٹا ٹیگز جنریٹر
SEO، Open Graph اور Twitter Cards کے لیے مکمل اور درست HTML میٹا ٹیگز تیار کریں۔
.gitignore فائل جنریٹر
Node.js, Python, Java, Go اور سینکڑوں فریم ورکس کے لیے حسب ضرورت .gitignore تیار کریں۔
اوپن سورس لائسنس جنریٹر
MIT, Apache 2.0, GPL اور BSD سمیت دیگر اوپن سورس لائسنسز کے متن کو حسب ضرورت بنائیں۔
README.md جنریٹر
اپنے اوپن سورس پروجیکٹس کے لیے بیجز اور سیکشنز کے ساتھ بہترین README بنائیں۔
SemVer کیلکولیٹر اور رینج چیکر
سیمنٹک ورژننگ رینجز، موازنے اور ورژنز کی مطابقت کا فوری جائزہ لیں۔
OpenAPI / Swagger دستاویزات ویور
OpenAPI 3.0 اور Swagger 2.0 تفصیلات کو انٹرایکٹو API دستاویزات کے طور پر دیکھیں۔
اکثر پوچھے گئے سوالات اور رازداری
ہر کمٹ کی قسم کس سیمنٹک ورژن بَمپ (bump) سے مطابقت رکھتی ہے؟
معیاری Conventional Commits روایات کے تحت، `fix` ایک PATCH بَمپ کو متحرک کرتا ہے، `feat` ایک MINOR بَمپ کو چلاتا ہے، اور `BREAKING CHANGE` پر مشتمل کوئی بھی کمٹ MAJOR بَمپ کا سبب بنتا ہے۔
کیا سبجیکٹ لائن کا اختتام فل اسٹاپ (ختمہ) پر ہونا چاہیے؟
نہیں، Conventional Commits کے بہترین طریقے آخر میں فل اسٹاپ کے بغیر ایک جامع امرائی جملے کی سفارش کرتے ہیں (مثلاً `feat: allow user avatar upload`)۔