Diktujte code review ve svém vlastním jazyce

Ve většině vývojářských nástrojů je potichu zapečený jeden předpoklad: kód je anglicky, takže vývojář musí být taky. Klíčová slova jsou anglicky. Názvy knihoven jsou anglicky. Chybové hlášky jsou anglicky. A tak, pokračuje ta úvaha, může být diktování pro vývojáře jen anglické a nikomu to nebude vadit.

Code review ten předpoklad rozbije okamžitě. Poznámka v review není kód. Je to věta adresovaná člověku — a ve spoustě týmů má ten člověk stejný mateřský jazyk jako vy. Rumunský tým dělající review Rust služby píše rumunské poznámky k anglickým identifikátorům. Polský tým totéž polsky, německý německy. Kód zůstává anglicky; konverzace o kódu ne.

Diktování je pro poznámky v review nezvykle dobré, protože review je čtecí činnost a psaní na klávesnici čtení přerušuje. Dobré je ale jen tehdy, když funguje v jazyce, ve kterém poznámka doopravdy je. Tenhle článek je o tom, jak to zařídit: jaké jazyky Keebye pokrývá přímo na zařízení, jak se chová připnutí jazyka a kde jsou hrany. Pokud chcete argumentaci, proč na tom vůbec záleží, tu nabízí Diktování by nemělo být jen anglicky; tohle je praktické pokračování.

Proč jsou poznámky v review ideální cíl pro diktování

Poznámka v review má tři vlastnosti, které z ní dělají lepší kandidáty na hlas než skoro jakýkoli jiný vývojářský text.

Je krátká. Většina poznámek má jednu až tři věty. To je jeden nádech, jedno podržení zkratky, jedna promluva.

Je to próza. Na rozdíl od commit message s pevným formátem nebo konfiguráku s přesnou syntaxí je poznámka v review prostě to, jak byste problém vysvětlili nahlas. „Tohle to zkouší donekonečna, pokud socket nikdy neodpoví; zastropuj to.“ Vyslovená a napsaná verze jsou skoro totožné.

Vzniká, když máte oči zaneprázdněné. Čtete diff. Ve chvíli, kdy se zastavíte a začnete psát, v něm ztratíte místo. Diktování vám dovolí číst dál a poznámku vyslovit do políčka, do kterého jste už klikli.

A teď přidejte jazykovou dimenzi. Pokud váš tým dělá review polsky, čistě anglický diktovací nástroj vás staví před volbu: dělat review anglicky (nepřirozené a kolegové to možná budou číst pomaleji), nebo psát (a přijít o výhodu). Ani jedno není to, co jste chtěli.

Co Keebye skutečně podporuje

Podstatné jsou tu dva enginy běžící na zařízení a stojí za to je popsat přesně.

Výchozí engine je laděný na angličtinu. Je rychlý, používá ho většina lidí a pro polskou poznámku v review to není ten pravý. Namířený na neanglickou řeč vyprodukuje foneticky pravděpodobnou angličtinu, která není tím, co jste řekli.

Druhý engine, Canary, pokrývá přesně 25 jazyků: bulharštinu, chorvatštinu, češtinu, dánštinu, nizozemštinu, angličtinu, estonštinu, finštinu, francouzštinu, němčinu, řečtinu, maďarštinu, italštinu, lotyštinu, litevštinu, maltštinu, polštinu, portugalštinu, rumunštinu, ruštinu, slovenštinu, slovinštinu, španělštinu, švédštinu a ukrajinštinu. Je volitelný, stáhne se jednou a pak běží offline jako všechno ostatní v Keebye. Ne sto jazyků; dvacet pět, vyjmenovaných — a pokud ten váš na seznamu není, tenhle článek vám zatím nepomůže.

Existuje ještě možnost použít jako engine nativní rozpoznávání řeči od Applu, které přináší vlastní jazykové pokrytí vašeho Macu. To je samostatná cesta s jinými vlastnostmi; zbytek článku je o Canary.

Připněte jazyk; nenechte ho hádat

Nejdůležitější nastavení pro neanglické review je připnutí jazyka.

Automatická detekce zní jako správný výchozí stav a pro vývojáře je špatná. Poznámky v review jsou nahusto plné anglických identifikátorů: názvů funkcí, názvů balíčků, slov „null“, „async“ a „callback“. Poznámka, která je z osmdesáti procent česká a z dvaceti procent složená z anglických tokenů, dá detektoru jazyka přesně ten smíšený signál, který zvládá nejhůř. Překlopí se uprostřed věty, nebo rozhodne, že to celé byla angličtina — a vy dostanete přepis, který je sebejistě špatně. Automatická detekce se pořád plete: připněte si jazyk rozebírá to selhání podrobně.

S Canary vám Keebye dovolí nastavit jazyk explicitně. Připnete rumunštinu a model dekóduje rumunštinu; anglické identifikátory uvnitř vaší věty se berou jako přejatá slova, ne jako důkaz, že jste přepnuli jazyk. Rozpoznání neobvyklého identifikátoru může být pořád nedokonalé, ale jazyk sám přestane být hozením mince.

Jeden detail chování stojí za zapamatování: připnutý jazyk se čte pro následující promluvu. Změníte připnutí a diktování, které se teprve chystáte udělat, ho použije; to, které jste už pustili, se znovu nepřepíše. V praxi to znamená: nejdřív přepnout, pak mluvit. Pokud během dne děláte review ve dvou jazycích, je to přepnutí levné. Lišta nabízí užší výběr 11 jazyků pro rychlé přepnutí, Nastavení nabízí všech 25.

Jedno review, nadiktované

Takhle vypadá sezení v týmu, který dělá review rumunsky.

Otevřete pull request. V liště je od včerejška připnutá rumunština, takže není co řešit. Přečtete první soubor. Třetí hunk, retry smyčka bez stropu. Kliknete do políčka pro poznámku, podržíte pravou ⌘, řeknete poznámku rumunsky, pustíte. Text přistane, „ehm“ a falešný start odstranilo čištění podle pravidel a identifikátor reconnectSocket je netknutý, protože jste si ho před týdnem přidali do vlastního slovníku.

Další soubor. Poznámka, kterou chcete nechat, je návrh kódu, ne próza. Tuhle napíšete; diktovat diff je špatný zážitek v jakémkoli jazyce.

Později se do vlákna přidá přispěvatel z jiného týmu a píše anglicky. Chcete odpovědět anglicky. Kliknete na lištu, vyberete ze zkráceného seznamu angličtinu a další promluva se dekóduje jako angličtina. Odpovíte a přepnete zpátky.

Nic z toho nepotřebuje okno. Keebye zůstává v liště; zkratka funguje v té aplikaci, která má fokus — ať už je to záložka prohlížeče s review, desktopový Git klient, nebo terminál s CLI nástrojem na review.

Upřímné limity

Dvacet pět jazyků, ne všechny. Pokud děláte review turecky, japonsky, arabsky nebo v jakémkoli jazyce mimo seznam Canary, druhý engine ho nepokrývá. Nativní engine od Applu možná ano, podle jazykové podpory vašeho systému — ale to je jiný engine s jiným chováním.

Zkrácený seznam v liště má jedenáct položek. Angličtina, rumunština, francouzština, němčina, španělština, italština, portugalština, nizozemština, polština, ruština a ukrajinština jsou dvě kliknutí daleko. Zbylých čtrnáct je v Nastavení. Pokud vaše každodenní dvojice obsahuje třeba češtinu a finštinu, jedna strana půjde přes Nastavení.

Identifikátory zůstávají identifikátory. Řečový model si v jakémkoli jazyce láme zuby na snake_case_names. Slovník pomůže s těmi opakujícími se, zbytek opravíte ručně. Než poznámku odešlete, přečtěte si ji.

Žádný živý přepis. Canary přepisuje při puštění klávesy, v jedné dávce. Neuvidíte slova, jak je říkáte. U poznámky v review o jedné až třech větách je to sotva znát.

Doleštění je volitelné a výchozí stav je doslovný. Když zapnete doleštění lokálním LLM na zařízení, uhladí strukturu vět — a kontrola věrnosti se vrátí k surovému přepisu, pokud výstup vykazuje vážnou ztrátu tokenů, rozbujení nebo opakování. Ta kontrola je heuristika; neověřuje, že váš význam přežil. U poznámek v review, kde otočený zápor mění verdikt, si většina lidí doleštění nechává vypnuté a práci nechá na čištění podle pravidel.

Kam to zapadá

Pokud je pro vás připnutí jazyka ta nejdůležitější funkce, Keebye vs Wispr Flow obě aplikace srovnává v tom, kde běží rozpoznávání řeči a jak se zachází s jazykem — včetně toho, kde se Wispr Flow hodí líp. Pro širší téma diktování ve chvíli, kdy máte ruce na diffu, pokrývá každodenní praxi průvodce pro vývojáře a nastavení průvodce pro Mac.

Předpoklad, že vývojáři mluví jen anglicky, nikdy nebyl pravdivý. Byl jen pohodlný pro nástroje. Dělat review ve vlastním jazyce, hlasem, s řečí, která nikdy neopustí váš stroj, není okrajový požadavek. Je to to, co by dělala velká část lidí píšících software, kdyby jim to nástroje umožnily.