Membuat Pesan Git Commit yang Baik untuk kolaborasi

Git bukan sekadar alat untuk menyimpan kode, melainkan sarana komunikasi antar pengembang. Salah satu aspek terpenting dalam penggunaan Git adalah penulisan pesan commit. Pesan yang terstruktur membantu tim memahami histori perubahan tanpa harus membedah baris kode satu per satu.

Mengenal Tipe Perubahan

Langkah pertama dalam menulis pesan commit yang baik adalah menentukan kategori perubahan yang Anda lakukan. Penggunaan prefix atau tipe di awal pesan memberikan konteks instan bagi siapa pun yang melihat log sistem. Berikut adalah standar yang umum digunakan:

• feat: Digunakan saat menambahkan fitur baru ke dalam aplikasi.
• fix: Digunakan ketika Anda melakukan perbaikan bug atau error.
• docs: Digunakan untuk perubahan yang hanya berkaitan dengan dokumentasi (README, wiki, dll).
• style: Digunakan untuk perubahan format visual (CSS, spasi, semi-colon) yang tidak mengubah logika kode.
• refactor: Digunakan saat merapikan kode tanpa menambah fitur atau memperbaiki bug.

Menulis Subjek yang Ringkas

Subjek adalah judul dari pesan commit Anda. Bagian ini harus mampu menjelaskan apa yang dilakukan dalam satu baris. Aturan emasnya adalah menjaga panjang karakter di bawah 50 karakter.

"Gunakan kalimat perintah seperti 'tambah fungsi login' daripada 'saya sudah menambahkan fungsi login'."

Jangan akhiri subjek dengan tanda titik karena secara visual ini adalah sebuah judul, bukan paragraf. Fokuslah pada esensi perubahan agar rekan tim dapat memindai git log dengan cepat.

Kapan Membutuhkan Penjelasan (Body)?

Tidak semua commit membutuhkan penjelasan panjang. Namun, jika perubahan yang Anda buat bersifat kompleks atau memiliki alasan teknis tertentu yang tidak terlihat langsung dari kode, gunakan bagian Body.

Pisahkan subjek dengan body menggunakan satu baris kosong. Pastikan setiap baris dalam penjelasan tidak lebih dari 80 karakter agar tetap nyaman dibaca melalui terminal atau antarmuka web.

Footer dan Keterkaitan Issue

Bagian terakhir adalah Footer. Ini sangat berguna dalam manajemen proyek yang menggunakan Issue Tracker. Anda bisa menyertakan nomor issue yang berkaitan untuk otomatisasi status tugas. Misalnya, menggunakan kata kunci seperti Closes #123.

Contoh Implementasi Nyata