Apa yang membuat komit dan pesan komit yang baik?

Question

Accepted Answer

Komit yang baik adalah **terfokus** (satu perubahan logis) dengan **pesan yang jelas** yang menjelaskan apa yang berubah dan mengapa. Komit dan pesan yang dirancang dengan baik membuat riwayat proyek mudah dibaca, berguna untuk memahami perubahan, debugging, dan kolaborasi.

## Pesan komit 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
```

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

## Komit yang baik: atomic dan terfokus

```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 (standar populer)

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

Memahami apa yang membuat komit dan pesan komit yang baik sangat berharga untuk **menciptakan riwayat proyek yang mudah dibaca dan berguna**, sehingga pengetahuan praktis yang penting ini secara signifikan mempengaruhi kolaborasi dan pemeliharaan. **Pesan komit yang baik** penting karena riwayat komit adalah bentuk dokumentasi yang sangat penting — pesan yang jelas (ringkasan singkat yang menjelaskan *apa* yang berubah, dengan isi yang menjelaskan *mengapa* jika diperlukan) memungkinkan Anda memahami bagaimana dan mengapa kode berkembang, yang sangat berharga saat meninjau riwayat, debugging (memahami mengapa perubahan dilakukan), atau onboarding.

Pesan yang tidak jelas ("fixed stuff", "update", "wip") membuat riwayat tidak berguna, sehingga mustahil memahami perubahan di kemudian hari — biaya nyata.

Konvensi **imperative mood** ("Add feature" bukan "Added feature") adalah standar yang luas diikuti dan patut diketahui. **Komit yang baik menjadi atomic dan terfokus** (setiap komit satu perubahan logis, bukan banyak perubahan yang tidak terkait digabungkan) sama pentingnya: komit yang terfokus jauh lebih mudah untuk **ditinjau** (peninjau memahami satu perubahan), **dikembalikan** (membatalkan satu perubahan dengan bersih tanpa mempengaruhi yang lain), dipahami, dan **dibiseksi** (menemukan komit mana yang memperkenalkan bug) — jadi struktur komit secara langsung mempengaruhi seberapa berguna riwayat untuk debugging dan kolaborasi.

Mengetahui tentang **Conventional Commits** (standar `type(scope): description` yang memungkinkan changelog otomatis dan versioning) berharga karena diadopsi secara luas.

Karena riwayat komit adalah dokumentasi penting dan komit/pesan yang baik membuatnya mudah dibaca dan berguna (untuk memahami, meninjau, debugging, dan kolaborasi) sementara yang buruk membuatnya tidak berguna, dan karena membuat komit yang terfokus dengan pesan yang jelas adalah ciri praktik Git profesional, memahami apa yang membuat komit dan pesan komit yang baik adalah pengetahuan praktis yang berharga untuk kolaborasi yang efektif dan riwayat yang dapat dipertahankan — keterampilan yang membedakan pengembang yang cermat dan secara bermakna meningkatkan kegunaan jangka panjang proyek dan alur kerja tim.