Diktujte revízie kódu vo vlastnom jazyku

Vo väčšine vývojárskych nástrojov je zapečený tichý predpoklad: kód je po anglicky, takže vývojár musí byť tiež. Kľúčové slová sú anglické. Názvy knižníc sú anglické. Chybové hlášky sú anglické. A tak, hovorí tá úvaha, môže byť diktovanie pre vývojárov iba anglické a nikomu to nebude prekážať.

Revízia kódu ten predpoklad okamžite rozbíja. Komentár k revízii nie je kód. Je to veta adresovaná človeku — a vo veľkom množstve tímov ten človek zdieľa váš prvý jazyk. Rumunský tím revidujúci službu v Ruste píše rumunské komentáre o anglických identifikátoroch. Poľský tím to isté po poľsky, nemecký po nemecky. Kód zostáva anglický; rozhovor o kóde nie.

Diktovanie je pre komentáre k revízii nezvyčajne dobré, lebo revízia je čítacia činnosť a písanie čítanie prerušuje. Dobré je však len vtedy, keď funguje v jazyku, v ktorom je komentár naozaj napísaný. Tento text je o tom, ako to rozbehať: ktoré jazyky Keebye pokrýva priamo na zariadení, ako sa správa pripnutie jazyka a kde sú hrany. Ak chcete argument, prečo na tom vôbec záleží, prináša ho diktovanie nemá byť len po anglicky; toto je praktické pokračovanie.

Prečo sú komentáre k revízii ideálnym cieľom diktovania

Komentár k revízii má tri vlastnosti, vďaka ktorým sadne hlasu lepšie než takmer akýkoľvek iný vývojársky text.

Je krátky. Väčšina komentárov má jednu až tri vety. To je jeden nádych, jedno podržanie skratky, jedna výpoveď.

Je to próza. Na rozdiel od commit správy s pevným formátom alebo konfiguračného súboru s presnou syntaxou je komentár k revízii jednoducho to, ako by ste problém vysvetlili nahlas. „Toto to skúša donekonečna, ak socket nikdy neodpovie; daj tomu strop.“ Vyslovená a napísaná verzia sú takmer identické.

Deje sa to, kým sú vaše oči zamestnané. Čítate diff. V okamihu, keď zastanete, aby ste písali, stratíte v ňom miesto. Diktovanie vám dovolí čítať ďalej a komentár vysloviť do vstupného poľa, do ktorého ste už klikli.

Teraz pridajte jazykový rozmer. Ak váš tím revidoval po poľsky, čisto anglický diktovací nástroj vynúti voľbu: revidovať po anglicky (neprirodzené a kolegovia to možno čítajú pomalšie), alebo písať (a prísť o výhodu). Ani jedno nie je to, čo ste chceli.

Čo Keebye naozaj podporuje

Podstatné sú tu dva enginy bežiace na zariadení a oplatí sa byť v nich presný.

Predvolený engine je ladený na angličtinu. Je rýchly, používa ho väčšina ľudí a nie je to ten, ktorý chcete na poľský komentár k revízii. Namierený na neanglickú reč vyprodukuje fonetiky verne znejúcu angličtinu, ktorá nie je tým, čo ste povedali.

Druhý engine, Canary, pokrýva presne 25 jazykov: bulharčinu, chorvátčinu, češtinu, dánčinu, holandčinu, angličtinu, estónčinu, fínčinu, francúzštinu, nemčinu, gréčtinu, maďarčinu, taliančinu, lotyštinu, litovčinu, maltčinu, poľštinu, portugalčinu, rumunčinu, ruštinu, slovenčinu, slovinčinu, španielčinu, švédčinu a ukrajinčinu. Je voliteľný, sťahuje sa raz a potom beží offline ako všetko ostatné v Keebye. Nie sto jazykov; dvadsaťpäť, vymenovaných — a ak ten váš na zozname nie je, tento text vám zatiaľ nepomôže.

Existuje aj možnosť použiť ako engine natívne rozpoznávanie reči od Apple, ktoré prináša vlastné jazykové pokrytie na vašom Macu. To je samostatná cesta s inými vlastnosťami; zvyšok tohto textu je o Canary.

Pripnite jazyk, nenechajte ho hádať

Najdôležitejším nastavením pre neanglickú revíziu je pripnutie jazyka.

Automatická detekcia znie ako správne predvolené nastavenie a je tým nesprávnym pre vývojárov. Komentáre k revízii sú husté anglickými identifikátormi: názvy funkcií, názvy balíkov, slová „null“, „async“ a „callback“. Komentár, ktorý je na osemdesiat percent rumunský a na dvadsať percent tvorený anglickými tokenmi, dáva detektoru jazyka presne ten zmiešaný signál, ktorý zvláda najhoršie. Preklopí sa uprostred vety, alebo vyhlási celok za angličtinu — a vy dostanete prepis, ktorý je sebavedomo nesprávny. Detailne to zlyhanie rozoberá Pripnite si jazyk diktovania.

S Canary vám Keebye dovolí nastaviť jazyk výslovne. Pripnite rumunčinu a model dekóduje rumunčinu; anglické identifikátory vo vašej vete spracuje ako prevzaté slová, nie ako dôkaz, že ste prepli jazyk. Rozpoznanie nezvyčajného identifikátora môže byť stále nedokonalé, ale samotný jazyk prestane byť hodom mincou.

Jeden detail správania stojí za zmienku: pripnutý jazyk sa načíta pre nasledujúcu výpoveď. Zmeňte pripnutie a diktovanie, ktoré sa práve chystáte urobiť, ho použije; to, ktoré ste už pustili, sa znova neprepíše. V praxi to znamená: najprv prepnite, potom hovorte. Ak počas dňa revidujete v dvoch jazykoch, prepínanie je lacné. Lišta v menu bare ponúka na rýchle prepínanie užší zoznam 11 jazykov, v Nastaveniach je všetkých 25.

Nadiktovaná relácia revízie

Takto vyzerá relácia v tíme, ktorý revidoval po rumunsky.

Otvoríte pull request. V lište je od včera pripnutá rumunčina, takže netreba nič robiť. Čítate prvý súbor. Tretí hunk, retry cyklus bez stropu. Kliknete do poľa na komentár, podržíte pravý ⌘, poviete komentár po rumunsky, pustíte. Text pristane, s „ehm“ a jedným falošným štartom odstráneným čistením podľa pravidiel, a s identifikátorom reconnectSocket nedotknutým, lebo ste ho pred týždňom pridali do vlastného slovníka.

Ďalší súbor. Komentár, ktorý chcete nechať, je návrh kódu, nie próza. Ten napíšete; diktovať diff je zlý zážitok v akomkoľvek jazyku.

Neskôr sa do vlákna pridá prispievateľ z iného tímu a píše po anglicky. Chcete odpovedať po anglicky. Kliknete na lištu, vyberiete zo zoznamu angličtinu a ďalšia výpoveď sa dekóduje ako angličtina. Odpoviete a prepnete späť.

Nič z toho nepotrebuje okno. Keebye zostáva v menu bare; klávesová skratka funguje v tej aplikácii, ktorá má práve fokus — či je to karta prehliadača s revíziou, desktopový Git klient, alebo terminál s CLI nástrojom na revízie.

Úprimné limity

Dvadsaťpäť jazykov, nie všetky. Ak revidujete po turecky, japonsky, arabsky alebo v akomkoľvek jazyku mimo zoznamu Canary, druhý engine ho nepokrýva. Natívny engine od Apple ho pokrývať môže, podľa jazykovej podpory vášho systému, ale to je iný engine s iným správaním.

Zoznam v lište má jedenásť položiek. Angličtina, rumunčina, francúzština, nemčina, španielčina, taliančina, portugalčina, holandčina, poľština, ruština a ukrajinčina sú na dve kliknutia. Zvyšných štrnásť je v Nastaveniach. Ak vaša každodenná dvojica obsahuje povedzme češtinu a fínčinu, jedna strana pôjde cez Nastavenia.

Identifikátory zostávajú identifikátormi. Rečový model má v každom jazyku ťažkosti s nazvami_v_snake_case. Slovník pomáha s tými opakujúcimi sa, zvyšok opravíte rukou. Prečítajte si komentár, než ho zverejníte.

Žiadny živý prepis. Canary prepisuje pri pustení klávesu, jednou dávkou. Slová sa počas hovorenia neobjavujú. Pri komentári k revízii dlhom jednu až tri vety to sotva zbadáte.

Doladenie je voliteľné a predvolene doslovné. Ak zapnete doladenie lokálnym LLM na zariadení, upraví stavbu viet a strážca vernosti sa vráti k surovému prepisu, keď výstup vykazuje ťažkú stratu tokenov, rozpínanie alebo opakovanie. Ten strážca je heuristika; nekontroluje, či prežil váš význam. Pri komentároch k revízii, kde otočený zápor mení verdikt, väčšina ľudí necháva doladenie vypnuté a prácu prenechá čisteniu podľa pravidiel.

Kam to zapadá

Ak je pripnutie jazyka funkciou, na ktorej vám záleží najviac, Keebye vs Wispr Flow porovnáva oba nástroje v tom, kde reč beží a ako sa narába s jazykom — vrátane toho, kde sa Wispr Flow hodí lepšie. Pre širší prípad diktovania s rukami na diffe pokrýva každodennú prax návod pre vývojárov a nastavenie návod pre Mac.

Predpoklad, že vývojári hovoria len po anglicky, nebol nikdy pravdivý. Bol len pohodlný pre nástroje. Revidovať vo vlastnom jazyku, hlasom, s rečou, ktorá nikdy neopustí váš počítač, nie je okrajová požiadavka. Je to to, čo by robila veľká časť ľudí píšucich softvér, keby im to nástroje dovolili.