Merge PR: Merge, Squash, Rebase

Tiga tombol hijau di GitHub

PR di-approve, checks hijau, saatnya merge. GitHub menawarkan tiga cara, dan pilihanmu membentuk riwayat main setahun ke depan:

1. Create a merge commit: semua commit PR masuk apa adanya, plus 1 merge commit. Riwayatnya jujur, tapi bisa berisik kalau PR berisi 20 commit "wip", "fix typo", "coba lagi".
2. Squash and merge: seluruh PR digabung jadi satu commit di main. Riwayat main super bersih: satu PR = satu commit dengan pesan yang rapi.
3. Rebase and merge: commit-commit PR ditempel ulang di atas main tanpa merge commit. Linear dan rapi, tapi tiap commit harus lolos CI satu per satu.

Kenapa penting? git log di main adalah dokumentasi tim: satu commit bermakna per fitur mengalahkan ratusan "wip".

Contoh 1: melihat bedanya di git log

PR berisi 4 commit berantakan. Dengan merge commit biasa, log main jadi:

git log --oneline -5

Semua sampah ikut masuk. Dengan squash, log main jadi:

git log --oneline -2

Satu baris yang jelas. Itu kenapa squash jadi default favorit.

Contoh 2: squash merge dari terminal + beres-beres

Tidak harus klik tombol di browser; bisa dari terminal:

gh pr merge 17 --squash

Setelah merge, branch sumber sudah tidak berguna. Hapus agar tidak menumpuk jadi sampah:

git switch main
git pull
git branch -d fitur-notifikasi

GitHub juga menampilkan tombol "Delete branch" otomatis setelah merge; biasakan menekannya agar branch mati tidak menumpuk.

Kapan pakai yang mana?

• Squash: default terbaik. PR berantakan masuk, satu commit rapi keluar.
• Merge commit: kalau tiap commit PR memang bermakna dan layak dipertahankan.
• Rebase: kalau tim menjaga riwayat linear ketat dan tiap commit harus atomic.

Banyak repo mengunci pilihan ini di Settings. Ikuti aturan repo.

Menulis pesan squash yang baik

Saat squash, GitHub memakai judul PR sebagai pesan commit yang hidup selamanya di git log. Inilah kenapa modul pr-buat menekankan judul spesifik.

Catatan teknis: squash dan rebase menulis ulang commit, jadi JANGAN dipakai di branch yang dishare tanpa koordinasi. Setelah squash-merge, hapus paksa branch lokalmu (git branch -D) lalu buat ulang dari main yang baru.

Kapan menekan tombol merge?

Hanya jika: checks hijau, approve tercapai, thread resolved, diff terakhir dibaca ulang. Merge itu murah; bug yang lolos karena review terburu-buru itu mahal.

Kesalahan umum pemula

SALAH: merge padahal checks masih merah.

gh pr merge 17 --squash   # padahal CI gagal!

"Ah, test-nya kayaknya cuma flaky." Jangan. Checks merah berarti ada yang salah; tugasmu mencari tahu apa. Kode yang di-merge dengan CI merah adalah bom waktu.

BENAR: hijau dulu, baru merge.

Tunggu CI selesai dan hijau. Kalau merah, baca log-nya, perbaiki, push lagi, dan biarkan CI jalan ulang. Baru setelah hijau, merge.

Kesalahan kedua: lupa menghapus branch setelah merge. Jadikan kebiasaan: setiap selesai merge, langsung hapus branch-nya, lokal maupun remote.