Cara Membuat Deskripsi Pull Request (PR) yang Disukai Senior Developer

Seni Komunikasi Asinkron di Perusahaan IT

Saat bekerja di perusahaan teknologi, kodemu tidak langsung masuk ke produk utama. Kamu harus menyerahkan kodemu ke teman tim (atau Senior Developer) melalui sistem Pull Request (PR) di GitHub/GitLab untuk ditinjau (Code Review).

Melihat kode orang lain itu memusingkan. Jika kamu memberikan judul PR "Fix Error Update" dengan kolom deskripsi kosong, temanmu harus menebak-nebak apa yang sebenarnya kamu kerjakan. Hasilnya? PR-mu akan diabaikan berhari-hari. Berikut adalah struktur PR yang menjamin Approve secepat kilat!

Struktur Emas Sebuah Pull Request

1. Berikan Konteks (Mengapa kode ini ada?)

Senior-mu memegang 5 proyek berbeda. Ingatkan mereka! Jangan mulai dengan teknis, mulailah dengan masalah bisnis.
Contoh: "Memperbaiki bug #123 di mana pengguna yang baru daftar tidak bisa langsung mengeklik keranjang belanja karena token JWT tidak tersimpan di Cookie."

2. Jelaskan Solusi Teknis Singkat

Berikan ringkasan (1-2 kalimat) tentang bagaimana caramu memecahkan masalah tadi agar *Reviewer* punya gambaran di kepalanya sebelum melihat ratusan baris kodenya.
Contoh: "Saya memindahkan penyimpanan token dari LocalStorage ke HttpOnly Cookie melalui *middleware* axios *interceptor*."

3. Visualkan (Screenshot atau Rekam Layar!)

Ini adalah *Cheat Code* (jalan pintas) paling ampuh. Manusia adalah makhluk visual. Jika kamu mengubah tampilan UI atau menambal *Error Alert*, sertakan gambar tangkapan layar (Sebelum dan Sesudah) atau GIF pergerakan animasi (Screen Record 5 detik). Reviewer akan langsung jatuh cinta padamu karena mereka tidak perlu menarik kodemu ke laptop mereka (Local Test) hanya untuk melihat hasilnya!

4. Langkah Pengujian (How to Test)

Sediakan instruksi jelas bagaimana QA (Quality Assurance) atau *Reviewer* bisa memicu *error* tersebut dan mengetes perbaikanmu.
Contoh: "1. Login dengan akun uji coba. 2. Klik menu keranjang. 3. Pastikan sekarang tidak ada pop-up error 401."

Kesimpulan

Menulis deskripsi PR yang lengkap mungkin menambah 5 menit pekerjaanmu. Namun, 5 menit investasi itu akan memangkas proses Code Review yang biasanya memakan waktu 2 Hari menjadi hanya 2 Jam. Menulis dan mengkomunikasikan kode dengan beradab adalah ciri mutlak seorang Engineer level Senior.