Diktē koda pārskatus savā valodā

Lielākajā daļā izstrādātāju rīku ir iecepts kluss pieņēmums: kods ir angliski, tātad arī izstrādātājam jābūt angliskam. Atslēgvārdi ir angļu. Bibliotēku nosaukumi ir angļu. Kļūdu ziņojumi ir angļu. Un tātad, seko spriedums, diktēšana izstrādātājiem var būt tikai angliska un neviens neiebildīs.

Koda pārskats šo pieņēmumu salauž uzreiz. Pārskata komentārs nav kods. Tas ir teikums, adresēts cilvēkam, un ļoti daudzās komandās šim cilvēkam ir tā pati pirmā valoda, kas tev. Rumāņu komanda, kas pārskata Rust servisu, raksta rumāņu komentārus par angļu identifikatoriem. Poļu komanda dara to pašu poliski, vācu komanda vāciski. Kods paliek angļu; saruna par kodu — nē.

Diktēšana pārskatu komentāriem der neparasti labi, jo pārskatīšana ir lasīšanas darbība, un rakstīšana lasīšanu pārtrauc. Bet tā der tikai tad, ja strādā tajā valodā, kurā komentārs patiesībā ir. Šis raksts ir par to, kā to panākt: kuras valodas Keebye aptver uz ierīces, kā uzvedas valodas piefiksēšana un kur ir malas. Ja gribi argumentu, kāpēc tas vispār ir svarīgi, to sniedz raksts diktēšanai izstrādātājiem nevajadzētu būt tikai angliskai; šis ir praktiskais turpinājums.

Kāpēc pārskatu komentāri ir ideālais diktēšanas mērķis

Pārskata komentāram ir trīs īpašības, kas to padara par labāku balss kandidātu nekā gandrīz jebkuru citu izstrādātāja tekstu.

Tas ir īss. Lielākā daļa komentāru ir viens līdz trīs teikumi. Tā ir viena elpa, viena īsinājumtaustiņa turēšana, viens izteikums.

Tā ir proza. Atšķirībā no komitu ziņas ar stingru formātu vai konfigurācijas faila ar precīzu sintaksi pārskata komentārs ir vienkārši tas, kā tu problēmu izskaidrotu skaļi. „Šis mēģina bezgalīgi, ja ligzda nekad neatbild; ierobežo to.” Izrunātā un uzrakstītā versija ir gandrīz identiskas.

Tas notiek, kamēr acis ir aizņemtas. Tu lasi diff. Brīdī, kad apstājies, lai rakstītu, tu tajā pazaudē vietu. Diktēšana ļauj turpināt lasīt un komentāru ierunāt ievades laukā, kurā jau esi ieklikšķinājis.

Tagad pievieno valodas dimensiju. Ja tava komanda pārskata poliski, tikai angliska diktēšanas lietotne uzspiež izvēli: pārskatīt angliski (nedabiski, un kolēģi to var lasīt lēnāk) vai rakstīt (zaudējot ieguvumu). Neviens no tiem nav tas, ko gribēji.

Ko Keebye patiesībā atbalsta

Šeit svarīgi ir divi uz ierīces darbojošies dzinēji, un ir vērts par tiem būt precīzam.

Noklusējuma dzinējs ir pielāgots angļu valodai. Tas ir ātrs, to lieto lielākā daļa, un tas nav tas, ko gribi poļu pārskata komentāram. Vērsts pret runu, kas nav angļu, tas saražos fonētiski ticamu angļu valodu, kas nav tas, ko pateici.

Otrs dzinējs, Canary, aptver tieši 25 valodas: bulgāru, horvātu, čehu, dāņu, holandiešu, angļu, igauņu, somu, franču, vācu, grieķu, ungāru, itāļu, latviešu, lietuviešu, maltiešu, poļu, portugāļu, rumāņu, krievu, slovāku, slovēņu, spāņu, zviedru un ukraiņu. Tas ir pēc izvēles ieslēdzams, tas tiek lejupielādēts vienreiz, un pēc tam tas darbojas bezsaistē tāpat kā viss pārējais Keebye. Nevis simts valodu; divdesmit piecas, uzskaitītas, un, ja tavas starp tām nav, šis raksts tev vēl nevar palīdzēt.

Pastāv arī iespēja kā dzinēju izmantot Apple vietējo runas atpazīšanu, kas nāk ar savu valodu pārklājumu tavā Mac. Tas ir atsevišķs ceļš ar citām īpašībām; pārējā raksta daļa ir par Canary.

Piefiksē valodu; neļauj tai minēt

Vissvarīgākais iestatījums pārskatiem, kas nav angliski, ir valodas piefiksēšana.

Automātiskā noteikšana izklausās pēc pareizā noklusējuma un izstrādātājiem ir nepareizais. Pārskatu komentāri ir blīvi ar angļu identifikatoriem: funkciju nosaukumiem, pakotņu nosaukumiem, vārdiem „null”, „async” un „callback”. Komentārs, kas ir astoņdesmit procentu rumāņu un divdesmit procentu angļu simbolu, dod valodas noteicējam tieši to jaukto signālu, ar kuru tas tiek galā vissliktāk. Tas apmetīsies teikuma vidū vai izlems, ka viss bijis angliski, un tu iegūsi transkriptu, kas ir pārliecināti nepareizs. Kļūme detalizēti izstaigāta rakstā piefiksē savu diktēšanas valodu.

Ar Canary Keebye ļauj valodu iestatīt tieši. Piefiksē rumāņu, un modelis dekodē rumāņu; angļu identifikatori tavā teikumā tiek apstrādāti kā aizguvumi, nevis kā pierādījums, ka esi pārslēdzies. Neparasta identifikatora atpazīšana joprojām var būt nepilnīga, bet pati valoda pārstāj būt monētas mešana.

Viena uzvedības detaļa, ko ir vērts zināt: piefiksētā valoda tiek nolasīta nākamajam izteikumam. Nomaini piefiksējumu, un diktēšana, ko gatavojies veikt, to izmantos; tā, kuru jau atlaidi, netiek pārtranskribēta. Praksē tas nozīmē: vispirms pārslēdz, tad runā. Ja dienas gaitā pārskati divās valodās, pārslēgšana ir lēta. Izvēļņu joslas ikonā pieejams 11 valodu īsais saraksts ātrai pārslēgšanai, bet Iestatījumos ir visas 25.

Nodiktēta pārskata sesija

Lūk, kā izskatās sesija komandā, kas pārskata rumāņu valodā.

Tu atver izmaiņu pieprasījumu. Ikonā jau redzams no vakardienas piefiksētais rumāņu, tātad nekas nav jādara. Tu lasi pirmo failu. Trešais gabals, atkārtošanas cikls bez ierobežojuma. Ieklikšķini komentāru laukā, turi labo ⌘, pasaki komentāru rumāniski, atlaid. Teksts nonāk vietā, ar noteikumos balstīto tīrīšanu izņemtu „ē” un neveiksmīgu sākumu, un identifikatoru reconnectSocket neskartu, jo pirms nedēļas to pievienoji pielāgotajai vārdnīcai.

Nākamais fails. Komentārs, ko gribi atstāt, ir koda ierosinājums, nevis proza. To tu uzraksti; diff diktēšana jebkurā valodā ir slikta pieredze.

Vēlāk pavedienā pievienojas kolēģis no citas komandas un raksta angliski. Tu gribi atbildēt angliski. Klikšķini uz ikonas, izvēlies no īsā saraksta angļu, un nākamais izteikums tiek dekodēts kā angļu. Atbildi, tad pārslēdz atpakaļ.

Nekam no tā nav vajadzīgs logs. Keebye paliek izvēļņu joslā; īsinājumtaustiņš strādā tajā lietotnē, kurai ir fokuss, vai tā būtu pārlūka cilne ar pārskatu, darbvirsmas Git klients vai terminālis ar komandrindas pārskatu rīku.

Godīgi par ierobežojumiem

Divdesmit piecas valodas, ne visas. Ja pārskati turku, japāņu, arābu vai jebkurā citā valodā ārpus Canary saraksta, otrais dzinējs to neaptver. Apple vietējais dzinējs var to darīt atkarībā no tavas sistēmas valodu atbalsta, bet tas ir cits dzinējs ar citu uzvedību.

Ikonas īsais saraksts ir vienpadsmit. Angļu, rumāņu, franču, vācu, spāņu, itāļu, portugāļu, holandiešu, poļu, krievu un ukraiņu ir divu klikšķu attālumā. Pārējās četrpadsmit ir Iestatījumos. Ja tavā ikdienas pārī ir, teiksim, čehu un somu, viena tā puse iet caur Iestatījumiem.

Identifikatori joprojām ir identifikatori. Runas modelis jebkurā valodā cīnās ar snake_case_nosaukumiem. Vārdnīca palīdz ar atkārtojošajiem; pārējos izlabo ar roku. Pirms publicē, izlasi komentāru.

Nav tiešraides transkripcijas. Canary transkribē pēc taustiņa atlaišanas, kā vienu paketi. Tu neredzēsi vārdus, kamēr tos saki. Pārskata komentāram, kas ir viens līdz trīs teikumi garš, tas ir tikko manāmi.

Pieslīpēšana ir izvēles un pēc noklusējuma burtiska. Ja ieslēdz uz ierīces darbojošos lokālās LLM pieslīpēšanu, tā sakārto teikumu struktūru, un fidelitātes aizsargs atkāpjas pie neapstrādātā transkripta, kad izvadē parādās būtiska simbolu zudība, izplešanās vai atkārtošanās. Šis aizsargs ir heiristika; tas nepārbauda, vai tava nozīme izdzīvoja. Pārskatu komentāriem, kur apgriezts noliegums maina spriedumu, lielākā daļa pieslīpēšanu atstāj izslēgtu un ļauj darbu paveikt noteikumos balstītajai tīrīšanai.

Kur tas iederas

Ja valodas piefiksēšana ir funkcija, kas tev rūp visvairāk, Keebye vs Wispr Flow salīdzina abus pēc tā, kur notiek runas apstrāde un kā tiek risināta valoda, ieskaitot to, kur Wispr Flow der labāk. Plašākam gadījumam — diktēšanai, kamēr rokas ir pie diff, — ikdienu apraksta izstrādātāju ceļvedis, bet uzstādīšanu — Mac ceļvedis.

Pieņēmums, ka izstrādātāji ir tikai angliski, nekad nebija patiess. Tas vienkārši bija ērts rīkiem. Pārskatīt savā valodā, ar balsi, ar runu, kas nekad nepamet tavu datoru, nav niša. Tas ir tas, ko darītu liela daļa cilvēku, kuri raksta programmatūru, ja rīki to atļautu.