एक अच्छा commit और commit message क्या बनाता है?

Question

Accepted Answer

अच्छे commits **केंद्रित** होते हैं (एक तार्किक बदलाव) और उनके **स्पष्ट messages** होते हैं जो समझाते हैं कि क्या बदला और क्यों। सुनिर्मित commits और messages प्रोजेक्ट इतिहास को पठनीय, बदलावों को समझने, debugging और सहयोग के लिए उपयोगी बनाते हैं।

## अच्छे commit messages

```text
GOOD message structure:
  Short summary line (~50 chars, imperative mood, capitalized, no period)
  <blank line>
  Optional body: explain WHAT and WHY (not how — the code shows how),
  wrap at ~72 chars. Reference issues if relevant.
```

```text
✅ GOOD:
  Add user email validation to registration form

Validate email format before submission to prevent invalid
  accounts. Fixes #142.

❌ BAD:
  "fixed stuff", "update", "asdf", "changes", "wip"
  → vague, uninformative — useless when reviewing history later
```

## imperative mood परंपरा

```text
Write the summary as a COMMAND/instruction (imperative):
  ✓ "Add feature", "Fix bug", "Update docs", "Remove dead code"
  ✗ "Added feature", "Fixes bug", "Updating docs"
→ Convention: it reads as "this commit will [Add feature]" (matches Git's own messages).
```

## अच्छे commits: atomic और केंद्रित

```text
✓ ATOMIC — each commit is ONE logical change (not many unrelated changes lumped together)
✓ Focused — "Add login" and "Fix typo" are SEPARATE commits, not one
✓ Working — ideally each commit leaves the code in a working state
Why: focused commits are easier to REVIEW, REVERT (undo one change cleanly),
  understand, and bisect (find which commit introduced a bug).
```

## Conventional Commits (एक लोकप्रिय मानक)

```text
type(scope): description    → feat: add login | fix: handle null | docs: update README
  types: feat, fix, docs, refactor, test, chore, etc.
→ Enables automated changelogs/versioning; widely adopted in many projects.
```

## यह क्यों महत्वपूर्ण है

यह समझना कि अच्छे commits और commit messages क्या बनाते हैं **पठनीय, उपयोगी प्रोजेक्ट इतिहास बनाने** के लिए मूल्यवान है, इसलिए यह महत्वपूर्ण व्यावहारिक ज्ञान है जो सहयोग और रखरखाव को काफ़ी प्रभावित करता है। **अच्छे commit messages** मायने रखते हैं क्योंकि commit इतिहास documentation का एक महत्वपूर्ण रूप है — स्पष्ट messages (एक संक्षिप्त summary जो समझाती है कि *क्या* बदला, एक body के साथ जो ज़रूरत पड़ने पर *क्यों* समझाती है) यह समझना संभव बनाते हैं कि कोड कैसे और क्यों विकसित हुआ, जो इतिहास की समीक्षा, debugging (यह समझना कि बदलाव क्यों किया गया), या onboarding के समय अनमोल है।

अस्पष्ट messages ("fixed stuff", "update", "wip") इतिहास को बेकार बना देते हैं, बाद में बदलावों को समझना असंभव बना देते हैं — एक वास्तविक लागत।

**imperative mood परंपरा** ("Add feature" न कि "Added feature") एक व्यापक रूप से अपनाया गया मानक है जिसे जानना सार्थक है। **अच्छे commits का atomic और केंद्रित होना** (प्रत्येक commit एक तार्किक बदलाव, कई असंबंधित बदलाव एक साथ नहीं) समान रूप से महत्वपूर्ण है: केंद्रित commits को **review** करना (समीक्षक एक बदलाव समझते हैं), **revert** करना (दूसरों को प्रभावित किए बिना एक बदलाव साफ़ से undo करना), समझना, और **bisect** करना (यह पता लगाना कि किस commit ने bug पेश किया) कहीं आसान है — इसलिए commit संरचना सीधे प्रभावित करती है कि इतिहास debugging और सहयोग के लिए कितना उपयोगी है।

**Conventional Commits** के बारे में जानना (`type(scope): description` मानक जो स्वचालित changelogs और versioning को सक्षम बनाता है) मूल्यवान है क्योंकि यह व्यापक रूप से अपनाया गया है।

चूँकि commit इतिहास महत्वपूर्ण documentation है और अच्छे commits/messages इसे पठनीय और उपयोगी बनाते हैं (समझने, समीक्षा, debugging, और सहयोग के लिए) जबकि खराब वाले इसे बेकार बनाते हैं, और चूँकि स्पष्ट messages के साथ केंद्रित commits तैयार करना पेशेवर Git अभ्यास की एक पहचान है, यह समझना कि अच्छे commits और commit messages क्या बनाते हैं प्रभावी सहयोग और रखरखाव योग्य इतिहास के लिए मूल्यवान, व्यावहारिक रूप से प्रासंगिक ज्ञान है — एक कौशल जो विचारशील developers को अलग करता है और एक प्रोजेक्ट की दीर्घकालिक उपयोगिता और टीम workflow को सार्थक रूप से बेहतर बनाता है।