Komentar ulasan harus membantu penulis memahami apa yang perlu diperhatikan dan mengapa. Tunjukkan masalah perilaku, risiko, atau pemeliharaan tertentu daripada meninggalkan reaksi yang tidak jelas pada sebaris kode.
Buatlah alasannya terlihat
- Jelaskan skenario di mana kode saat ini bisa gagal atau membingungkan pengelola di masa mendatang.
- Pisahkan perubahan kebenaran atau keamanan yang diperlukan dari saran gaya opsional.
- Ajukan pertanyaan ketika Anda kekurangan konteks daripada berasumsi maksud penulisnya.
Tawarkan jalan ke depan
Jika berguna, sarankan alternatif atau tes yang dapat mengatasi masalah tersebut. Jaga agar perubahan yang diminta tetap proporsional dengan dampaknya; jangan menjadikan preferensi pribadi sebagai pemblokir rilis.
Tinjau perubahan penuhnya, tidak hanya dekorasi yang berbeda. Jika suatu masalah cukup penting untuk menghalangi penggabungan, rangkumlah masalah tersebut dengan jelas sehingga penulis dapat menemukan pekerjaan yang tersisa.