Code review untuk pemilik website dan aplikasi

Anda mengelola website, toko online, atau aplikasi kecil. Seseorang telah menulis kodenya: kontraktor, teman, agensi yang kini sudah tidak bekerja sama lagi, atau Anda sendiri setelah beberapa akhir pekan belajar dari tutorial. Kodenya berjalan, sebagian besar. Tetapi Anda tidak bisa tahu apakah kodenya kokoh atau hanya ditambal di sana-sini. Code review adalah pemeriksaan kedua oleh seseorang yang tidak menulisnya, dan menjawab pertanyaan itu sebelum masalah kecil berubah menjadi masalah yang mahal.

Code review untuk website atau aplikasi

Kapan review sepadan

Sebelum Anda membayar pekerjaan yang sudah selesai. Review menunjukkan apakah kode yang Anda terima masuk akal atau penuh jalan pintas.
Saat Anda mengambil alih sebuah proyek. Kode warisan tanpa dokumentasi adalah kotak hitam sampai ada yang menjelaskannya.
Saat sesuatu terus rusak. Formulir yang kadang gagal, halaman yang lambat, error yang muncul lagi setelah setiap perbaikan.
Sebelum peluncuran atau promo besar, ketika bug berarti kerugian uang sungguhan.
Saat Anda menulis kode sendiri dan ingin tahu apa yang bisa dilakukan lebih baik.

Apa yang ditemukan review

Peninjau membaca kode baris demi baris dan mencari:

Bug: logika yang gagal dalam kasus tertentu, seperti keranjang kosong, tanggal di akhir bulan, atau nama dengan apostrof.
Bagian berisiko: kata sandi yang ditulis langsung di kode, input pengguna yang dipakai tanpa pemeriksaan, pesan error yang membuka terlalu banyak informasi.
Titik lemah: kode yang berjalan sekarang tetapi akan rusak saat trafik bertambah atau library diperbarui.
Keterbacaan: nama yang tidak jelas, fungsi yang panjang, dan kode berulang yang membuat setiap perubahan berikutnya lebih lambat dan lebih mahal.

Masalah diurutkan berdasarkan tingkat kepentingannya, sehingga Anda tahu apa yang harus diperbaiki dulu dan apa yang bisa menunggu.

Apa yang tidak dilakukan review

Review membaca dan menjelaskan kode; review tidak menjalankannya di server Anda atau menguji situs live Anda. Review bukan audit keamanan menyeluruh atau uji beban. Anggap perbaikan yang disarankan sebagai usulan: siapa pun yang memelihara proyek harus menguji setiap perbaikan sebelum dipakai secara live.

Cara memilih apa yang dikirim

Seluruh situs jarang diperlukan. Pilih bagian yang paling penting:

Tempat uang berpindah: checkout, pembayaran, harga, dan diskon.
Tempat pengguna mengetik sesuatu: formulir pendaftaran, login, kontak, dan pencarian.
Tempat masalah muncul: file atau fungsi di balik error yang Anda lihat.

Beberapa ratus baris dari tempat yang tepat lebih banyak bercerita daripada ribuan baris dari semua bagian.

Cara menyiapkan kode

Hapus data rahasia. Ganti kata sandi, kunci API, dan data pelanggan dengan penanda seperti PASSWORD_HERE.
Sebutkan bahasa dan versinya, misalnya PHP 8 atau JavaScript dengan React.
Jelaskan apa yang seharusnya dilakukan kode dalam satu atau dua kalimat sederhana.
Salin pesan error persis seperti aslinya, jika ada, secara lengkap.
Sebutkan fokusnya: bug, kecepatan, keterbacaan, atau bagian berisiko.

Cara memakai hasilnya

Bagikan hasil review kepada siapa pun yang memelihara kode dan sepakati urutan perbaikannya, dimulai dari yang kritis. Jika Anda sendiri bukan orang teknis, ringkasan dalam bahasa sederhana membantu Anda mengajukan pertanyaan yang tepat dan menilai jawabannya.

Ringkasnya

Code review adalah pemeriksaan independen yang menemukan bug, bagian berisiko, dan titik lemah sebelum pelanggan Anda menemukannya. Jika Anda membutuhkannya, pesan code review: Anda menempelkan hingga 100, 400, atau 1.000 baris kode dan menjelaskan apa yang bermasalah, lalu menerima penjelasan tertulis tentang apa yang dilakukan kode, daftar masalah yang diurutkan berdasarkan tingkat kepentingan, dan potongan kode yang sudah diperbaiki untuk diuji di proyek Anda sendiri. Pembayaran baru dicairkan setelah Anda menerima hasil kerja.