Bagaimana anda menjalankan ulasan kod yang berkesan dan menghormati?

Question

Accepted Answer

Ulasan kod adalah salah satu aktiviti TL dengan leverage tertinggi: ia melindungi kualiti *dan* mengajar. Matlamatnya adalah **kod yang lebih baik dan pasukan yang lebih kuat**, bukan gatekeeping. Ulasan harus cepat, baik hati, dan fokus pada perkara yang penting.

## Prinsip

```text
✓ Review the CODE, never the person ("this function" not "you")
✓ Distinguish must-fix from nice-to-have (label nits explicitly)
✓ Ask questions, don't issue commands ("what about X?" invites discussion)
✓ Praise good work, not just problems
✓ Be fast — a PR blocked for two days kills momentum
✓ Approve when it's good enough, not perfect
```

## Contoh konkret

Daripada "Ini salah, gunakan peta," tulis: "nit: peta di sini dapat mengelakkan gelung bersarang, berbaloi? Tidak menyekat." Perkara yang sama, tetapi ia mengajar, meninggalkan ruang untuk tidak bersetuju, dan tidak menghalang penggabungan.

## Lihat dinamika kuasa

Sebagai TL, ulasan anda mempunyai berat tambahan. Satu "Saya akan melakukannya berbeza" yang santai boleh terasa seperti perintah. Jelas tentang apa yang merupakan kebimbangan sebenar berbanding pilihan, dan biarkan orang menolak.

## Mengapa ia penting

Ulasan menetapkan bar kualiti pasukan dan nada emosinya.

Ulasan keras membuat orang defensif dan lambat untuk dihantar.

Ulasan yang baik menangkap pepijat, menyebarkan pengetahuan, dan membuat jurutera lebih baik, berkompun dari masa ke masa.