Diktuok kodo peržiūras savo kalba

Į daugumą kūrėjų įrankių tyliai įrašyta prielaida: kodas yra angliškas, vadinasi, ir kūrėjas turi būti anglakalbis. Raktažodžiai angliški. Bibliotekų pavadinimai angliški. Klaidų pranešimai angliški. Taigi, tęsiant tą mintį, diktavimas kūrėjams gali būti tik angliškas ir niekam tai netrukdys.

Kodo peržiūra šią prielaidą sugriauna iš karto. Peržiūros komentaras nėra kodas. Tai sakinys, skirtas žmogui, o daugybėje komandų tas žmogus kalba ta pačia gimtąja kalba kaip ir tu. Rumunų komanda, peržiūrinti Rust paslaugą, rašo rumuniškus komentarus apie angliškus identifikatorius. Lenkų komanda daro tą patį lenkiškai, vokiečių — vokiškai. Kodas lieka angliškas; pokalbis apie kodą — ne.

Diktavimas neįprastai gerai tinka peržiūros komentarams, nes peržiūra yra skaitymo veikla, o spausdinimas skaitymą nutraukia. Bet jis geras tik tada, kai veikia ta kalba, kuria komentaras iš tikrųjų parašytas. Šis įrašas yra apie tai, kaip tai pasiekti: kokias kalbas Keebye padengia įrenginyje, kaip elgiasi kalbos prisegimas ir kur yra kraštai. Jei nori argumento, kodėl visa tai svarbu, jį pateikia diktavimas kūrėjams neturėtų būti tik angliškas; čia — praktinis tęsinys.

Kodėl peržiūros komentaras yra idealus diktavimo taikinys

Peržiūros komentaras turi tris savybes, dėl kurių jis balsui tinka geriau nei beveik bet koks kitas kūrėjo tekstas.

Jis trumpas. Dauguma komentarų yra nuo vieno iki trijų sakinių. Tai vienas įkvėpimas, vienas sparčiojo klavišo paspaudimas, vienas pasakymas.

Jis yra proza. Skirtingai nei griežto formato commit žinutė ar tikslios sintaksės konfigūracijos failas, peržiūros komentaras yra tiesiog tai, kaip paaiškintum problemą garsiai. „Jei lizdas niekada neatsako, tai kartojasi be galo; apribok.“ Ištarta ir surinkta versijos beveik identiškos.

Jis atsiranda tada, kai akys užimtos. Tu skaitai skirtumą. Tą akimirką, kai sustoji spausdinti, prarandi jame savo vietą. Diktavimas leidžia skaityti toliau ir įkalbėti komentarą į laukelį, į kurį jau spustelėjai.

Dabar pridėk kalbos matmenį. Jei tavo komanda peržiūras rašo lenkiškai, tik angliškai mokantis diktavimo įrankis verčia rinktis: peržiūrėti angliškai (nenatūralu, o kolegos gal skaitys lėčiau) arba spausdinti (prarandant naudą). Nei viena nėra tai, ko norėjai.

Ką Keebye iš tikrųjų palaiko

Čia svarbūs du įrenginyje veikiantys varikliai, ir verta apie juos kalbėti tiksliai.

Numatytasis variklis pritaikytas anglų kalbai. Jis greitas, jį naudoja dauguma žmonių, ir jis nėra tas, kurio nori lenkiškam peržiūros komentarui. Nukreiptas į ne anglišką kalbą, jis pagamins fonetiškai įtikimą anglų kalbą, kuri nėra tai, ką pasakei.

Antrasis variklis, Canary, apima lygiai 25 kalbas: bulgarų, kroatų, čekų, danų, olandų, anglų, estų, suomių, prancūzų, vokiečių, graikų, vengrų, italų, latvių, lietuvių, maltiečių, lenkų, portugalų, rumunų, rusų, slovakų, slovėnų, ispanų, švedų ir ukrainiečių. Jį reikia įjungti atskirai, jis atsisiunčiamas vieną kartą, o paskui veikia neprisijungus, kaip ir visa kita Keebye. Ne šimtas kalbų: dvidešimt penkios, išvardytos — ir jei tavosios sąraše nėra, šis įrašas kol kas negali padėti.

Yra ir galimybė varikliu pasirinkti Apple gimtąjį kalbos atpažinimą, kuris atsineša savo kalbų aprėptį tavo Mac kompiuteryje. Tai atskiras kelias su kitomis savybėmis; likusi įrašo dalis yra apie Canary.

Prisek kalbą; neleisk jos spėlioti

Vienintelė svarbiausia ne angliškos peržiūros nuostata yra kalbos prisegimas.

Automatinis aptikimas skamba kaip teisingas numatytasis variantas ir kūrėjams yra klaidingas. Peržiūros komentarai pilni angliškų identifikatorių: funkcijų pavadinimų, paketų pavadinimų, žodžių „null“, „async“ ir „callback“. Komentaras, kuris aštuoniasdešimt procentų rumuniškas ir dvidešimt procentų angliškų žetonų, kalbos aptikikliui duoda būtent tą mišrų signalą, kurį jis apdoroja blogiausiai. Jis persijungs sakinio viduryje arba nuspręs, kad visa tai buvo angliška, ir gausi užtikrintai klaidingą transkripciją. Prisek diktavimo kalbą detaliai išnarplioja šį gedimą.

Su Canary Keebye leidžia kalbą nustatyti aiškiai. Prisek rumunų — ir modelis dekoduoja rumuniškai; angliški identifikatoriai tavo sakinyje traktuojami kaip skoliniai, o ne kaip įrodymas, kad persijungei į kitą kalbą. Neįprasto identifikatoriaus atpažinimas vis tiek gali būti netobulas, bet pati kalba nustoja būti monetos metimu.

Vienas elgsenos niuansas, kurį verta žinoti: prisegta kalba nuskaitoma kitam pasakymui. Pakeisk prisegimą — ir diktavimas, kurį ketini atlikti, jį naudos; tas, kurį jau atleidai, iš naujo netranskribuojamas. Praktiškai tai reiškia: pirma perjunk, tada kalbėk. Jei per dieną peržiūras rašai dviem kalbomis, perjungimas pigus. Meniu juostos dėkle greitam perjungimui matomos 11 kalbų, o Nustatymuose — visos 25.

Padiktuota peržiūros sesija

Štai kaip atrodo sesija komandoje, kuri peržiūras rašo rumuniškai.

Atidarai pull request. Dėkle jau rodoma nuo vakar prisegta rumunų kalba, tad nieko daryti nereikia. Perskaitai pirmą failą. Trečias fragmentas — pakartojimo ciklas be ribos. Spusteli į komentaro laukelį, laikai dešinįjį Command, pasakai komentarą rumuniškai, atleidi. Tekstas atsiranda, „ėė“ ir klaidingas pradžios bandymas pašalinti taisyklėmis pagrįsto valymo, o identifikatorius reconnectSocket nepaliestas, nes prieš savaitę įtraukei jį į pasirinktinį žodyną.

Kitas failas. Komentaras, kurį nori palikti, yra kodo pasiūlymas, ne proza. Tą surenki klaviatūra; diktuoti skirtumą — bloga patirtis bet kuria kalba.

Vėliau į giją įsijungia bendradarbis iš kitos komandos ir rašo angliškai. Nori atsakyti angliškai. Spusteli dėklą, iš trumpojo sąrašo pasirenki anglų kalbą, ir kitas pasakymas dekoduojamas kaip angliškas. Atsakai ir perjungi atgal.

Nė vienam iš šių žingsnių nereikia lango. Keebye lieka meniu juostoje; spartusis klavišas veikia toje programoje, kuri turi fokusą — ar tai būtų naršyklės kortelė su peržiūra, darbalaukio Git klientas, ar terminalas su komandinės eilutės peržiūros įrankiu.

Sąžiningi apribojimai

Dvidešimt penkios kalbos, ne visos. Jei peržiūras rašai turkiškai, japoniškai, arabiškai ar bet kuria kalba už Canary sąrašo ribų, antrasis variklis tavęs nepadengia. Apple gimtasis variklis gali padengti, priklausomai nuo tavo sistemos kalbų palaikymo, bet tai kitas variklis su kitokia elgsena.

Trumpajame dėklo sąraše yra vienuolika. Anglų, rumunų, prancūzų, vokiečių, ispanų, italų, portugalų, olandų, lenkų, rusų ir ukrainiečių kalbos yra už dviejų spustelėjimų. Kitos keturiolika — Nustatymuose. Jei tavo kasdienėje poroje yra, tarkim, čekų ir suomių, viena jos pusė eina per Nustatymus.

Identifikatoriai vis tiek lieka identifikatoriais. Bet kurios kalbos kalbos modeliui sunku su snake_case_names. Žodynas padeda su pasikartojančiais; likusius taisai ranka. Perskaityk komentarą prieš jį paskelbdamas.

Jokios tiesioginės transkripcijos. Canary transkribuoja atleidus klavišą, vienu paketu. Nematysi žodžių, kol juos sakai. Peržiūros komentarui, kuris yra nuo vieno iki trijų sakinių, tai vos pastebima.

Gludinimas yra pasirenkamas ir pagal nutylėjimą pažodinis. Jei įjungi įrenginyje veikiančio vietinio LLM gludinimą, jis sutvarko sakinių struktūrą, o ištikimybės sargas grįžta prie neapdorotos transkripcijos, kai išvestis rodo didelį žetonų praradimą, išsiplėtimą ar kartojimąsi. Tas sargas yra euristika; jis netikrina, ar tavo prasmė išliko. Peržiūros komentaruose, kur apverstas neiginys pakeičia verdiktą, dauguma žmonių gludinimą palieka išjungtą ir leidžia darbą atlikti taisyklėmis pagrįstam valymui.

Kur tai dera

Jei kalbos prisegimas yra ta funkcija, kuri tau svarbiausia, Keebye ir Wispr Flow palygina abu pagal tai, kur vykdomas kalbos atpažinimas ir kaip tvarkoma kalba, įskaitant tai, kur Wispr Flow tinka geriau. Platesniam atvejui — diktavimui, kai rankos ant skirtumo — kūrėjų gidas apima kasdienybę, o Mac gidas — sąranką.

Prielaida, kad kūrėjai kalba tik angliškai, niekada nebuvo tiesa. Ji tiesiog buvo patogi įrankiams. Peržiūrėti savo kalba, balsu, su kalbos atpažinimu, kuris niekada nepalieka tavo kompiuterio, nėra nišinis prašymas. Būtent tai darytų didelė dalis programinę įrangą rašančių žmonių, jei įrankiai leistų.