Cara Menulis Pesan Commit yang Jelas dan Berguna

Riwayat Git bukan sekadar daftar cadangan. Ia membantu pengembang memahami kapan perilaku berubah, mencari asal bug, dan meninjau keputusan tanpa membaca seluruh kode dari awal.

Buat commit yang fokus

Kelompokkan perubahan berdasarkan satu tujuan logis. Hindari mencampur perbaikan bug, pemformatan massal, dan fitur baru dalam satu commit. Commit yang fokus lebih mudah ditinjau, diuji, atau dibatalkan.

Tulis subjek yang spesifik

Gunakan kalimat perintah singkat seperti perbaiki validasi email atau tambah filter status pesanan. Kata umum seperti update, fix, atau changes tidak memberi cukup konteks ketika dibaca beberapa bulan kemudian.

Jelaskan alasan bila perlu

Bagian isi dapat menerangkan masalah, pilihan solusi, dan dampak yang tidak terlihat dari diff. Fokus pada alasan dan batasan; kode sudah menunjukkan sebagian besar detail implementasi.

Contoh:

cegah pengiriman formulir tanpa kategori

Validasi sebelumnya hanya berjalan di tampilan klien sehingga
permintaan langsung masih dapat menyimpan kategori kosong.

Periksa sebelum menyimpan

Tinjau git diff, jalankan pengujian terkait, dan pastikan tidak ada berkas rahasia atau perubahan sementara. Referensikan nomor isu jika proyek menggunakannya.

Tidak ada format tunggal yang cocok untuk semua tim. Yang terpenting adalah konsistensi dan kemampuan pesan menjawab dua pertanyaan: apa yang berubah dan mengapa perubahan itu diperlukan.