Judul: Biar Riwayat Git Kamu Rapi, Begini Cara Nulis Commit Message yang Baik
—
Pembuka Singkat
Hai, para pejuang coding! Pernah nggak sih, pas lagi mantengin log `git log` terus lihat commit message kayak “fix”, “update”, atau “asdfasdf”? Aduh, rasanya pengen marah, ya? Commit message yang asal-asalan itu kayak catatan rapat yang cuma ditulis “rapat jam 2” – bikin bingung masa depan (alias diri sendiri atau rekan tim). Yuk, kita bahas cara nulis commit message yang baik, biar riwayat Git-mu jadi estetik dan gampang dilacak.
—
Inti Poin
1. Gunakan Kata Kerja Imperatif (Perintah)
Commit message terbaik pakai bentuk perintah, kayak lagi memberi instruksi pada repositori:
✅ `Add user authentication`
❌ `Added user authentication` atau `Adding user authentication`
✅ `Fix typo in README`
❌ `Fixed typo in README`
Kenapa imperatif? Karena commit itu action – kamu lagi “menerapkan perubahan” ini. Plus, konsisten dengan pesan default Git (`Merge branch…`).
2. Pisahkan Judul dan Detail dengan Baris Kosong
Aturan emas: judul maksimal 50 karakter, lalu enter dua kali, baru body. Body boleh lebih panjang, tapi usahakan tiap baris nggak lebih dari 72 karakter. Contoh:
“`
Refactor database connection pooling
– Menggunakan connection pool dari library X
– Menambah timeout handler
– Memperbaiki memory leak pada koneksi idle
“`
Kalau perubahan cuma kecil (misal typo), body bisa di-skip.
3. Jelaskan “Kenapa”, Bukan Cuma “Apa”
Kode sudah menjelaskan apa yang diubah. Coders butuh kenapa perubahan itu perlu. Contoh:
❌ `Remove console.log`
✅ `Remove debug logs that were left accidentally before production`
Atau:
❌ `Change button color`
✅ `Change button color to red to match brand guidelines`
4. Gunakan Awalan Kategori (Opsional, Tapi Berguna)
Biar commit gampang di-scan, tambahin tag kayak `feat:`, `fix:`, `refactor:`, `docs:`, dll. Ini populer di projects yang pake Conventional Commits. Contoh:
– `feat: add user profile page`
– `fix: resolve crash on empty search result`
– `docs: update API documentation`
Irit waktu juga pas bikin changelog otomatis.
5. Referensi Issue atau Ticket
Kalau commit terkait issue tertentu (misal di GitHub/GitLab), sebut nomornya di body atau akhir judul. Contoh:
“`
Fix validation error on login (#42)
Menambahkan pengecekan input kosong sebelum request ke server.
“`
Ini membantu siapa pun yang tracking bug atau fitur.
6. Jangan Takut Pakai Emoji (Tapi Pakai Bijak)
Emoji bisa bikin log lebih hidup, asal nggak lebay. Misal:
– 🐛 `fix: correct typo in variable name`
– ✨ `feat: add dark mode toggle`
Tapi jangan sampe commit message isinya cuma emoji doang ya.
—
Penutup: Insight
Commit message yang baik itu sebenarnya bentuk komunikasi asinkron antara kamu versi sekarang dengan kamu versi 6 bulan lagi (atau rekan tim yang baru join). Bayangin, commit log itu kayak diari proyek. Kalau diarinya penuh coretan nggak jelas, bakal susah nyari memory. Tapi kalau ditulis rapi, setiap commit jadi petunjuk yang membantu debugging, code review, dan git bisect.
Jadi, mulailah dari sekarang. Perlakukan commit message seperti surat cinta untuk masa depan. Nggak perlu puitis, tapi pastikan isinya jujur, jelas, dan bermanfaat. Selamat menulis commit, semoga Git log-mu jadi taman yang indah! 🌱