4 min read

Semantic Commit

Panduan nulis commit message yg terstruktur, rapi, dan gampang dipahami tim pake konvensi Semantic Commit.

#git #workflow #best practice #conventional commits

Apa Itu Semantic Commit?

Semantic Commit (sering disebut jg sbg Conventional Commits) adalah konvensi penulisan pesan commit di Git yg punya pola tertentu buat ngasih tau scr eksplisit tujuan dr perubahan kode yg dilakuin.

Bayangin pas kamu kerja dlm tim besar sm ratusan commit per minggu. Tanpa format yg jelas, riwayat commit bakal kacau dan susah ditelusuri. Semantic Commit berfungsi layaknya kamus terpadu biar seluruh anggota tim bisa langsung paham konteks perubahan cuma dr satu baris pesan commit 🧐.

Format Sebenarnya: Cuma 1 Baris!

Kenyataannya, 99% commit yg kita tulis sehari-hari itu ya cuma 1 baris:

bash
git commit -m "feat(auth): tambah login google"
git commit -m "fix(ui): perbaiki tombol back meleset"
git commit -m "refactor(blog): ringkaskan heading artikel"

Kamu cukup milih tipe perubahannya, sebutin lingkup (opsional), lalu tulis penjelasan singkatnya. Selesai!

Jenis" Tipe Commit

  • feat: Nambahin fitur baru (contoh: feat: buat halaman dashboard).
  • fix: Benerin bug atau eror (contoh: fix: atasi layout hancur di mobile).
  • docs: Update dokumentasi atau catatan (contoh: docs: update readme).
  • refactor: Bersihin atau rombak struktur kode tanpa ngubah fungsi (contoh: refactor: pisah modal jd komponen mandiri).
  • perf: Optimasi performa biar makin ngebut (contoh: perf: lazy load gambar gallery).
  • chore: Urusan perintilan, dependensi, atau build config (contoh: chore: bump dependencies).
  • style: Urusan format kode, spasi, atau titik koma yg ga ngaruh ke logika.

Kenapa Harus Pakai Semantic Commit?

  1. Gampang Telusuri Sejarah Kode (Git Log): Pas nyari tau kapan suatu bug muncul atau kapan sebuah fitur diperkenalkan, git log --oneline jd sangat gampang dibaca.
  2. Automasi Changelog: Tool otomatis kayak standard-version atau release-please bisa baca commit bertipe feat dan fix buat scr otomatis nge-generate berkas CHANGELOG.md dan nentuin versi SemVer berikutnya.
  3. Ningkatin Kolaborasi Tim: Code review jd jauh lebih cepat krn reviewer langsung tau apakah PR itu berisi perbaikan bug, fitur baru, atau sekadar refactoring.

Perbandingan: Buruk vs Rapi

Bayangin sebuah repo sm riwayat commit kayak gini:

❌ update
❌ upload gambar
❌ fix bug
❌ ganti button

Pesan commit di atas ga informatif. Bug apa yg diperbaiki? Gambar apa yg diunggah?

Bandingin kl ditulis pakai Semantic Commit:

✅ feat(navbar): implement responsive mobile drawer
✅ fix(api): handle timeout exception on watchlist fetch
✅ docs(readme): add installation command with bun
✅ chore(deps): bump tailwindcss to v4.0.0

Jauh lebih rapi, terstruktur, dan profesional! 👌

Kesimpulan

Meskipun ga ada undang" yg mewajibkan Semantic Commit buat proyek pribadi, biasain nulis commit yg rapi sejak awal bakal ngebentuk etos kerja developer yg disiplin, teliti, dan siap kerja dlm tim enterprise global.