एक अच्छो commit र commit message के हुन्छ?

Question

Accepted Answer

अच्छो commits **केन्द्रित** हुन्छन् (एक तार्किक परिवर्तन) **स्पष्ट सन्देशहरू** सहित जसले व्याख्या गर्छ कि के परिवर्तन भयो र किन। राम्रोसँग तैयार गरिएको commits र सन्देशहरूले प्रकल्प इतिहासलाई पठनीय, परिवर्तनहरू बुझ्नको लागि उपयोगी, डिबगिङ, र सहयोगका लागि उपयोगी बनाउँछन्।

## अच्छो commit सन्देशहरू

```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
```

## अनिवार्य 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 सन्देशहरूले के गरेको छ भन्ने कुरा बुझ्न **पठनीय, उपयोगी प्रकल्प इतिहास बनाउनको लागि** मूल्यवान छ, त्यसकारण यो महत्त्वपूर्ण व्यावहारिक ज्ञान हो जसले सहयोग र रखरखावलाई महत्त्वपूर्वक असर गर्छ। **अच्छो commit सन्देशहरू** महत्त्वपूर्ण छन् किनभने commit इतिहास दस्तावेजको एक महत्त्वपूर्ण रूप हो — स्पष्ट सन्देशहरू (सङ्क्षिप्त सारांश जसले व्याख्या गरेको छ कि *के* परिवर्तन भयो, आवश्यकता अनुसार *किन* व्याख्या गरेको शरीर सहित) यो सम्भव बनाउँछ कि कोड कसरी र किन विकसित भयो भन्ने कुरा बुझ्न, जो इतिहास समीक्षा गर्दा, डिबगिङ गर्दा (परिवर्तन किन गरिएको थियो भन्ने कुरा बुझ्न), वा नयाँ टिम सदस्यलाई सिखाउँदा अमूल्य छ।

अस्पष्ट सन्देशहरू ("fixed stuff", "update", "wip") इतिहासलाई बेकार बनाउँछन्, परिवर्तनहरू पछि बुझ्न असम्भव बनाउँछन् — एक वास्तविक लागत हो।

**अनिवार्य mood सम्मेलन** ("Add feature" "Added feature" होइन) एक व्यापक रूपमा अनुसरण गरिएको मानक हो जसलाई जान्न योग्य छ। **अच्छो commits atomic र केन्द्रित हुनु** (प्रत्येक commit एक तार्किक परिवर्तन, धेरै असम्बन्धित परिवर्तनहरू एकसाथ नगरी) समान रूपमा महत्त्वपूर्ण छ: केन्द्रित commits **समीक्षा** गर्न धेरै सजिलो हुन्छन् (समीक्षाकर्ताहरू एक परिवर्तन बुझ्छन्), **revert** गर्न (एक परिवर्तन सफाइसँग हटाउँदा अन्य परिवर्तनहरू असर नगरी), बुझ्न, र **bisect** गर्न (कुन commit ले त्रुटि ल्यायो भन्ने कुरा खोज्न) — त्यसकारण commit संरचनाले इतिहास डिबगिङ र सहयोगको लागि कति उपयोगी छ भन्ने कुरामा सीधै असर गर्छ।

**Conventional Commits** (automated changelogs र versioning सक्षम गर्ने `type(scope): description` मानक) को बारेमा जानु मूल्यवान छ किनभने यो व्यापक रूपमा अवलम्बन गरिएको छ।

Commit इतिहास महत्त्वपूर्ण दस्तावेज भएको र अच्छो commits/सन्देशहरूले यसलाई पठनीय र उपयोगी बनाएको (बुझ्न, समीक्षा गर्न, डिबग गर्न, र सहयोग गर्नको लागि) जबकि खराब सन्देशहरूले यसलाई बेकार बनाएको हुँदा, र केन्द्रित commits स्पष्ट सन्देशहरू सहित तैयार गर्नु व्यावसायिक Git अभ्यासको एक विशेषता भएको हुँदा, अच्छो commits र commit सन्देशहरूले के गरेको छ भन्ने कुरा बुझ्न प्रभावकारी सहयोग र रक्षणीय इतिहासको लागि मूल्यवान, व्यावहारिक प्रासङ्गिक ज्ञान हो — एक कौशल जसले विचारशील विकासकर्ताहरूलाई छुट्टिन्छ र प्रकल्पको दीर्घकालीन उपयोगिता र टिम कार्यप्रवाह अर्थपूर्वक सुधार गर्छ।