Apa yang menjadikan commit dan mesej commit yang baik?

Question

Accepted Answer

Commit yang baik adalah **fokus** (satu perubahan logik) dengan **mesej yang jelas** yang menerangkan apa yang berubah dan mengapa. Commit dan mesej yang dibentuk dengan baik menjadikan sejarah projek mudah dibaca, berguna untuk memahami perubahan, debugging, dan kolaborasi.

## Mesej commit yang baik

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

## Konvensyen 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).
```

## Commit yang baik: atomik dan fokus

```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 (satu standard popular)

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

## Mengapa ia penting

Memahami apa yang menjadikan commit dan mesej commit yang baik adalah bernilai untuk **mencipta sejarah projek yang mudah dibaca dan berguna**, jadi ia merupakan pengetahuan praktikal penting yang banyak mempengaruhi kolaborasi dan kebolehselenggaraan. **Mesej commit yang baik** penting kerana sejarah commit ialah bentuk dokumentasi yang penting — mesej yang jelas (ringkasan padat yang menerangkan *apa* yang berubah, dengan badan yang menerangkan *mengapa* apabila perlu) membolehkan kita memahami bagaimana dan mengapa kod berkembang, yang amat bernilai apabila menyemak sejarah, debugging (memahami mengapa sesuatu perubahan dibuat), atau onboarding.

Mesej yang kabur ("fixed stuff", "update", "wip") menjadikan sejarah tidak berguna, menyebabkan mustahil untuk memahami perubahan kemudian — satu kos yang sebenar.

**Konvensyen imperative mood** ("Add feature" bukan "Added feature") ialah standard yang diikuti secara meluas dan berbaloi untuk diketahui. **Commit yang baik bersifat atomik dan fokus** (setiap commit satu perubahan logik, bukan banyak perubahan tidak berkaitan ditimbun bersama) sama pentingnya: commit yang fokus jauh lebih mudah untuk **disemak** (penyemak memahami satu perubahan), **dikembalikan** (membatalkan satu perubahan dengan bersih tanpa menjejaskan yang lain), difahami, dan **dibisect** (mencari commit mana yang memperkenalkan pepijat) — jadi struktur commit secara langsung mempengaruhi betapa berguna sejarah itu untuk debugging dan kolaborasi.

Mengetahui tentang **Conventional Commits** (standard `type(scope): description` yang membolehkan changelog dan versioning automatik) adalah bernilai kerana ia diterima pakai secara meluas.

Memandangkan sejarah commit ialah dokumentasi penting dan commit/mesej yang baik menjadikannya mudah dibaca dan berguna (untuk memahami, menyemak, debugging, dan kolaborasi) manakala yang lemah menjadikannya tidak berguna, dan memandangkan membentuk commit yang fokus dengan mesej yang jelas merupakan ciri amalan Git profesional, memahami apa yang menjadikan commit dan mesej commit yang baik merupakan pengetahuan bernilai yang relevan secara praktikal untuk kolaborasi yang berkesan dan sejarah yang boleh diselenggara — kemahiran yang membezakan pembangun yang teliti dan secara bermakna meningkatkan kebolehgunaan jangka panjang projek serta aliran kerja pasukan.