Dikteeri koodiülevaatused omas keeles

Enamikku arendajate tööriistadesse on vaikselt sisse küpsetatud üks eeldus: kood on inglise keeles, järelikult peab ka arendaja olema. Võtmesõnad on inglise keeles. Teekide nimed on inglise keeles. Veateated on inglise keeles. Ja seega, käib arutluskäik, võib arendajate dikteerimine olla ainult ingliskeelne ja keegi ei pane pahaks.

Koodiülevaatus lõhub selle eelduse otsekohe. Ülevaatuskommentaar ei ole kood. See on inimesele adresseeritud lause, ja väga paljudes tiimides jagab see inimene su emakeelt. Rumeenia tiim, kes vaatab üle Rusti teenust, kirjutab inglise identifikaatorite kohta rumeeniakeelseid kommentaare. Poola tiim teeb sama poola keeles, saksa tiim saksa keeles. Kood jääb ingliskeelseks; jutt koodist mitte.

Dikteerimine sobib ülevaatuskommentaaride jaoks ebatavaliselt hästi, sest ülevaatus on lugemistegevus ja trükkimine katkestab lugemise. Aga see sobib ainult siis, kui see töötab keeles, milles kommentaar päriselt on. See lugu räägib selle tööle saamisest: milliseid keeli Keebye seadmes katab, kuidas keelekinnitus käitub ja kus on servad. Kui tahad põhjendust, miks see üldse loeb, siis selle esitab dikteerimine ei tohiks olla ainult ingliskeelne; see siin on praktiline järg.

Miks ülevaatuskommentaarid on dikteerimise ideaalne sihtmärk

Ülevaatuskommentaaril on kolm omadust, mis teevad sellest häälele parema sobivuse kui peaaegu ühelgi teisel arendajateksti liigil.

See on lühike. Enamik kommentaare on ühe kuni kolme lause pikkused. See on üks hingetõmme, üks kiirklahvi hoidmine, üks lausung.

See on proosa. Erinevalt jäiga vorminguga commit-sõnumist või täpse süntaksiga konfifailist on ülevaatuskommentaar lihtsalt see, kuidas sa probleemi valjusti seletaksid. „See proovib igavesti uuesti, kui pistik kunagi ei vasta; pane sellele piir.“ Räägitud ja trükitud versioon on peaaegu identsed.

See juhtub siis, kui su silmad on hõivatud. Sa loed diffi. Sel hetkel, kui trükkimiseks peatud, kaotad selles oma koha. Dikteerimine laseb sul edasi lugeda ja kommentaari sisse rääkida kasti, kuhu sa juba klõpsasid.

Lisa nüüd keelemõõde. Kui su tiim vaatab üle poola keeles, sunnib ainult ingliskeelne dikteerimistööriist valikule: vaata üle inglise keeles (ebaloomulik, ja kolleegid võivad seda aeglasemalt lugeda) või trüki (kaotades kasu). Kumbki ei ole see, mida sa tahtsid.

Mida Keebye tegelikult toetab

Siin loeb kaks seadmesisest mootorit ja nende kohta tasub olla täpne.

Vaikimisi mootor on häälestatud inglise keelele. See on kiire, seda kasutab enamik inimesi, ja see ei ole see, mida sa poolakeelse ülevaatuskommentaari jaoks tahad. Mitteingliskeelse kõne peale suunatuna toodab see foneetiliselt usutavat inglise keelt, mis ei ole see, mida sa ütlesid.

Teine mootor, Canary, katab täpselt 25 keelt: bulgaaria, horvaadi, tšehhi, taani, hollandi, inglise, eesti, soome, prantsuse, saksa, kreeka, ungari, itaalia, läti, leedu, malta, poola, portugali, rumeenia, vene, slovaki, sloveeni, hispaania, rootsi ja ukraina keel. See on valikuline, laaditakse alla üks kord ja töötab pärast seda võrguühenduseta nagu kõik muu Keebye’s. Mitte sada keelt, vaid kakskümmend viis, loetletult, ja kui sinu oma nimekirjas ei ole, ei saa see lugu sind veel aidata.

Samuti on võimalus kasutada mootorina Apple’i enda kõnetuvastust, mis toob kaasa oma keelekatvuse su Macis. See on eraldi tee teiste omadustega; ülejäänud lugu räägib Canaryst.

Kinnita keel; ära lase tal arvata

Kõige tähtsam seade mitteingliskeelse ülevaatuse jaoks on keelekinnitus.

Automaattuvastus kõlab õige vaikeväärtusena ja on arendajate jaoks vale. Ülevaatuskommentaarid on tihedalt täis ingliskeelseid identifikaatoreid: funktsioonide nimed, pakinimed, sõnad „null“, „async“ ja „callback“. Kommentaar, mis on kaheksakümmend protsenti rumeenia ja kakskümmend protsenti ingliskeelseid tokeneid, annab keeletuvastajale täpselt selle segasignaali, millega ta kõige halvemini hakkama saab. Ta kas pöörab keset lauset või otsustab, et kogu asi oli inglise keeles, ja sa saad enesekindlalt vale transkriptsiooni. Kinnita oma dikteerimiskeel käib selle ebaõnnestumise üksikasjalikult läbi.

Canary puhul laseb Keebye sul keele selgesõnaliselt seada. Kinnita rumeenia keel ja mudel dekodeerib rumeenia keelt; su lause sees olevaid ingliskeelseid identifikaatoreid koheldakse laensõnadena, mitte tõendina, et sa vahetasid keelt. Ebatavalise identifikaatori tuvastus võib ikka ebatäiuslik olla, aga keel ise lakkab olemast kulli ja kirja.

Üks käitumisdetail, mida tasub teada: kinnitatud keelt loetakse järgmise lausungi jaoks. Muuda kinnitust ja dikteering, mille sa kohe teed, kasutab seda; seda, mille sa juba lahti lasid, uuesti ei transkribeerita. Praktikas tähendab see: vaheta, siis räägi. Kui vaatad päeva jooksul üle kahes keeles, on vahetus odav. Menüüriba salv näitab kiireks vahetamiseks 11 keele lühinimekirja ja seadetes on kõik 25.

Üks ülevaatusseanss, dikteeritult

Nii näeb seanss välja tiimis, mis vaatab üle rumeenia keeles.

Avad pull requesti. Salvel on rumeenia keel eilsest juba kinnitatud, nii et midagi teha ei ole. Loed esimest faili. Kolmas tükk, kordustsükkel ilma piirita. Klõpsad kommentaarikasti, hoiad paremat ⌘, ütled kommentaari rumeenia keeles, lased lahti. Tekst maandub, „um“ ja üks valestart reeglipõhise puhastuse poolt eemaldatud, ja identifikaator reconnectSocket puutumatuna, sest lisasid selle nädal tagasi kohandatud sõnastikku.

Järgmine fail. Kommentaar, mille sa jätta tahad, on koodisoovitus, mitte proosa. Selle trükid. Diffi dikteerimine on halb kogemus igas keeles.

Hiljem liitub lõimega teise tiimi kaastööline ja kirjutab inglise keeles. Sa tahad vastata inglise keeles. Klõpsad salve, valid lühinimekirjast inglise keele, ja järgmine lausung dekodeeritakse inglise keelena. Vastad ja vahetad tagasi.

Miski sellest ei vaja akent. Keebye jääb menüüribale; kiirklahv töötab selles rakenduses, millel on fookus, olgu see brauserisakk ülevaatusega, töölaua Giti klient või terminal, kus jookseb käsurea ülevaatustööriist.

Ausad piirid

Kakskümmend viis keelt, mitte kõik. Kui vaatad üle türgi, jaapani, araabia või mõnes muus Canary nimekirjast väljas olevas keeles, siis teine mootor seda ei kata. Apple’i enda mootor võib katta, sõltuvalt su süsteemi keeletoest, aga see on teine mootor teistsuguse käitumisega.

Salve lühinimekirjas on üksteist. Inglise, rumeenia, prantsuse, saksa, hispaania, itaalia, portugali, hollandi, poola, vene ja ukraina keel on kahe klõpsu kaugusel. Ülejäänud neliteist on seadetes. Kui su igapäevases paaris on näiteks tšehhi ja soome keel, käib üks pool sellest seadete kaudu.

Identifikaatorid jäävad identifikaatoriteks. Kõnemudel näeb igas keeles snake_case_names puhul vaeva. Sõnastik aitab korduvatega; ülejäänu parandad käsitsi. Loe kommentaar enne postitamist läbi.

Reaalajas transkriptsiooni ei ole. Canary transkribeerib klahvi lahtilaskmisel, ühe partiina. Sa ei näe sõnu sel ajal, kui neid ütled. Ühe kuni kolme lause pikkuse ülevaatuskommentaari puhul on seda vaevu märgata.

Viimistlus on valikuline ja vaikimisi sõnasõnaline. Kui lülitad sisse seadmesisese kohaliku LLM-i viimistluse, korrastab see lausestruktuuri ja täpsuskaitse taandub toorele transkriptsioonile, kui väljund näitab tõsist tokenikadu, paisumist või kordamist. See kaitse on heuristika; see ei kontrolli, kas su tähendus ellu jäi. Ülevaatuskommentaaride puhul, kus ümberpööratud eitus muudab otsust, jätab enamik inimesi viimistluse välja ja laseb reeglipõhisel puhastusel töö ära teha.

Kuhu see sobitub

Kui keelekinnitus on funktsioon, mis sind kõige rohkem huvitab, siis Keebye vs Wispr Flow võrdleb neid kahte selles, kus kõnetuvastus töötab ja kuidas keelt käsitletakse, sealhulgas selles, kus Wispr Flow paremini sobib. Laiema juhtumi jaoks, kus dikteerid, käed diffil, katab arendajate juhend igapäevast tööd ja Maci juhend seadistuse.

Eeldus, et arendajad on ainult ingliskeelsed, ei ole kunagi tõsi olnud. See oli lihtsalt tööriistadele mugav. Omas keeles, häälega, kõnega, mis su masinast kunagi ei lahku, üle vaadata ei ole nišisoov. Seda teeks suur osa tarkvara kirjutavatest inimestest, kui tööriistad neil laseksid.