Imlakkan Code Review dalam Bahasa Anda Sendiri

Ada satu andaian senyap yang terbina dalam kebanyakan perkakas pembangun: kodnya dalam bahasa Inggeris, jadi pembangunnya pun mesti begitu. Kata kunci dalam bahasa Inggeris. Nama pustaka dalam bahasa Inggeris. Mesej ralat dalam bahasa Inggeris. Maka, kata alasan itu, imlak untuk pembangun boleh jadi bahasa Inggeris sahaja dan tiada siapa akan kisah.

Code review mematahkan andaian itu serta-merta. Satu komen review bukan kod. Ia satu ayat yang ditujukan kepada seorang manusia, dan dalam banyak pasukan manusia itu berkongsi bahasa pertama anda. Satu pasukan Romania yang mereview servis Rust menulis komen Romania tentang pengecam Inggeris. Satu pasukan Poland melakukan perkara sama dalam bahasa Poland, satu pasukan Jerman dalam bahasa Jerman. Kod itu kekal Inggeris; perbualan tentang kod itu tidak.

Imlak luar biasa baik untuk komen review, kerana review ialah aktiviti membaca dan menaip mengganggu pembacaan. Tetapi ia hanya baik jika ia berfungsi dalam bahasa yang komen itu sebenarnya ditulis. Artikel ini tentang menjadikan itu berkesan: bahasa mana yang Keebye rangkumi on-device, bagaimana semat bahasa berkelakuan, dan di mana pinggirnya. Jika anda mahukan hujah kenapa semua ini penting, imlak untuk pembangun tidak sepatutnya bahasa Inggeris sahaja menyampaikannya; yang ini sekuel praktikalnya.

Kenapa komen review ialah sasaran imlak yang ideal

Satu komen review ada tiga sifat yang menjadikannya lebih sesuai untuk suara berbanding hampir mana-mana teks pembangun yang lain.

Ia pendek. Kebanyakan komen satu hingga tiga ayat. Itu satu nafas, satu tahanan hotkey, satu ucapan.

Ia prosa. Tidak seperti mesej commit dengan format ketat atau fail config dengan sintaks yang tepat, komen review hanyalah cara anda akan menerangkan masalah itu dengan lantang. “Ini akan retry selama-lamanya jika soket itu tidak pernah menjawab; hadkan ia.” Versi tuturan dan versi taipan hampir serupa.

Ia berlaku semasa mata anda sibuk. Anda sedang membaca satu diff. Saat anda berhenti untuk menaip, anda kehilangan tempat anda di dalamnya. Mengimlak membolehkan anda terus membaca dan menuturkan komen itu ke dalam kotak input yang sudah pun anda klik.

Sekarang tambah dimensi bahasa. Jika pasukan anda mereview dalam bahasa Poland, alat imlak bahasa Inggeris sahaja memaksa satu pilihan: review dalam bahasa Inggeris (tidak semula jadi, dan rakan sepasukan anda mungkin membacanya lebih perlahan) atau menaip (kehilangan faedahnya). Kedua-duanya bukan yang anda mahu.

Apa yang Keebye sebenarnya sokong

Dua enjin on-device penting di sini, dan berbaloi untuk tepat tentang kedua-duanya.

Enjin lalai ditala untuk bahasa Inggeris. Ia pantas, ia yang kebanyakan orang guna, dan ia bukan yang anda mahu untuk komen review dalam bahasa Poland. Ditujukan pada pertuturan bukan Inggeris, ia akan menghasilkan bahasa Inggeris yang munasabah secara fonetik tetapi bukan apa yang anda sebut.

Enjin kedua, Canary, merangkumi tepat 25 bahasa: Bulgaria, Croatia, Czech, Denmark, Belanda, Inggeris, Estonia, Finland, Perancis, Jerman, Greek, Hungary, Itali, Latvia, Lithuania, Malta, Poland, Portugis, Romania, Slovak, Slovenia, Sepanyol, Sweden, Rusia dan Ukraine. Ia bersifat pilihan, ia dimuat turun sekali, dan selepas itu ia berjalan luar talian seperti semua benda lain dalam Keebye. Bukan seratus bahasa; dua puluh lima, disenaraikan, dan jika bahasa anda tiada dalam senarai itu artikel ini belum boleh membantu anda.

Ada juga pilihan menggunakan pengecaman pertuturan asli Apple sebagai enjin, yang membawa rangkuman bahasanya sendiri pada Mac anda. Itu laluan berasingan dengan ciri berbeza; selebihnya artikel ini tentang Canary.

Semat bahasanya; jangan biar ia meneka

Tetapan paling penting untuk review bukan Inggeris ialah semat bahasa.

Pengesanan automatik berbunyi seperti lalai yang betul dan ia lalai yang salah untuk pembangun. Komen review padat dengan pengecam Inggeris: nama fungsi, nama pakej, perkataan “null” dan “async” dan “callback”. Satu komen yang lapan puluh peratus bahasa Romania dan dua puluh peratus token Inggeris memberi pengesan bahasa tepat isyarat bercampur yang paling teruk dikendalikannya. Ia akan berpaling di tengah ayat, atau memutuskan keseluruhannya bahasa Inggeris, dan anda akan mendapat transkrip yang salah dengan penuh yakin. Semat bahasa imlak anda menyusuri kegagalan itu secara terperinci.

Dengan Canary, Keebye membenarkan anda menetapkan bahasa secara eksplisit. Semat bahasa Romania dan model itu menyahkod bahasa Romania; pengecam Inggeris dalam ayat anda dikendalikan sebagai kata pinjaman dan bukan sebagai bukti bahawa anda bertukar bahasa. Pengecaman pengecam yang luar biasa masih boleh tidak sempurna, tetapi bahasa itu sendiri berhenti menjadi lambungan syiling.

Satu butiran kelakuan yang berbaloi diketahui: bahasa yang disemat dibaca untuk ucapan seterusnya. Tukar sematnya dan imlak yang anda hampir buat menggunakannya; yang sudah anda lepaskan tidak ditranskrip semula. Dalam praktik ini bermakna: tukar dahulu, kemudian bercakap. Jika anda mereview dalam dua bahasa sepanjang hari, pertukaran itu murah. Tray menu bar mendedahkan senarai pendek 11 bahasa untuk pertukaran pantas, dan Settings mendedahkan kesemua 25.

Satu sesi review, diimlak

Beginilah rupa satu sesi dalam pasukan yang mereview dalam bahasa Romania.

Anda membuka pull request itu. Tray sudah menunjukkan bahasa Romania disemat sejak semalam, jadi tiada apa perlu dibuat. Anda membaca fail pertama. Bahagian ketiga, satu gelung retry tanpa had. Klik ke dalam kotak komen, tahan Right ⌘, sebut komen itu dalam bahasa Romania, lepas. Teks itu mendarat, dengan “um” dan satu permulaan palsu dibuang oleh pembersihan berasaskan peraturan, dan pengecam reconnectSocket kekal utuh kerana anda menambahnya ke dalam kamus tersuai seminggu lalu.

Fail seterusnya. Komen yang anda mahu tinggalkan ialah cadangan kod, bukan prosa. Yang itu anda taip; mengimlak satu diff ialah pengalaman buruk dalam mana-mana bahasa.

Kemudian, seorang penyumbang dari pasukan lain menyertai thread itu dan menulis dalam bahasa Inggeris. Anda mahu membalas dalam bahasa Inggeris. Klik tray, pilih Inggeris daripada senarai pendek, dan ucapan seterusnya dinyahkod sebagai bahasa Inggeris. Balas, kemudian tukar kembali.

Tiada satu pun daripada ini memerlukan tetingkap. Keebye kekal dalam menu bar; hotkey itu berfungsi dalam mana-mana aplikasi yang fokus, sama ada tab pelayar dengan review itu, klien Git desktop, atau terminal yang menjalankan alat review CLI.

Had yang jujur

Dua puluh lima bahasa, bukan semuanya. Jika anda mereview dalam bahasa Turki, Jepun, Arab, atau mana-mana bahasa di luar senarai Canary, enjin kedua itu tidak merangkuminya. Enjin asli Apple mungkin merangkuminya, bergantung pada sokongan bahasa sistem anda, tetapi itu enjin berbeza dengan kelakuan berbeza.

Senarai pendek tray ialah sebelas. Inggeris, Romania, Perancis, Jerman, Sepanyol, Itali, Portugis, Belanda, Poland, Rusia dan Ukraine berada dua klik jauhnya. Empat belas yang lain ada dalam Settings. Jika pasangan harian anda termasuk, katakan, Czech dan Finland, satu bahagiannya melalui Settings.

Pengecam tetap pengecam. Model pertuturan dalam mana-mana bahasa bergelut dengan nama_snake_case. Kamus membantu untuk yang berulang; selebihnya anda betulkan sendiri. Baca komen itu sebelum anda menyiarkannya.

Tiada transkripsi langsung. Canary mentranskrip pada pelepasan kekunci, sebagai satu batch. Anda tidak akan melihat perkataan semasa anda menyebutnya. Untuk satu komen review sepanjang satu hingga tiga ayat, ini hampir tidak terasa.

Penggilapan itu pilihan dan harfiah secara lalai. Jika anda menghidupkan penggilapan LLM setempat on-device, ia mengemaskan struktur ayat dan satu pengawal kesetiaan berundur kepada transkrip mentah apabila outputnya menunjukkan kehilangan token yang teruk, pengembangan, atau pengulangan. Pengawal itu heuristik; ia tidak menyemak bahawa makna anda terselamat. Untuk komen review, di mana satu penafian yang terbalik mengubah keputusan, kebanyakan orang membiarkan penggilapan itu dimatikan dan membiarkan pembersihan berasaskan peraturan melakukan kerjanya.

Di mana ini sesuai

Jika semat bahasa ialah ciri yang paling anda ambil berat, Keebye vs Wispr Flow membandingkan kedua-duanya dari segi di mana pertuturan diproses dan bagaimana bahasa dikendalikan, termasuk di mana Wispr Flow lebih sesuai. Untuk kes yang lebih luas — mengimlak sementara tangan anda pada diff — panduan pembangun merangkumi kerja harian, dan panduan Mac merangkumi persediaan.

Andaian bahawa pembangun itu bahasa Inggeris sahaja tidak pernah benar. Ia cuma mudah untuk alat-alat itu. Mereview dalam bahasa anda sendiri, dengan suara, dengan pertuturan yang tidak pernah keluar dari mesin anda, bukan permintaan niche. Itulah yang akan dilakukan oleh sebahagian besar orang yang menulis perisian jika perkakasnya membenarkan.