Диктувайте ревюта на код на своя език

В повечето инструменти за разработчици е вградено едно тихо допускане: кодът е на английски, значи и разработчикът трябва да е англоезичен. Ключовите думи са на английски. Имената на библиотеките са на английски. Съобщенията за грешка са на английски. И оттам разсъждението продължава: диктуването за разработчици може да бъде само на английски и никой няма да има нищо против.

Ревюто на код разбива това допускане веднага. Коментарът в ревю не е код. Той е изречение, отправено към човек, а в много екипи този човек говори същия първи език като вас. Румънски екип, който ревюира услуга на Rust, пише коментари на румънски за английски идентификатори. Полски екип прави същото на полски, немски — на немски. Кодът си остава английски; разговорът за кода — не.

Диктуването е необичайно добро именно за коментари в ревю, защото ревюто е дейност на четене, а писането прекъсва четенето. Но е добро само ако работи на езика, на който всъщност е коментарът. Тази статия е за това как да го постигнете: кои езици покрива Keebye на устройството, как се държи фиксирането на езика и къде са ръбовете. Ако искате аргумента защо изобщо това има значение, диктуването за разработчици не бива да е само на английски го излага; тук е практическото продължение.

Защо коментарите в ревю са идеалната цел за диктуване

Коментарът в ревю има три свойства, които го правят по-подходящ за глас от почти всеки друг текст, който разработчикът пише.

Кратък е. Повечето коментари са едно до три изречения. Това е едно поемане на дъх, едно задържане на клавиша, едно изказване.

Проза е. За разлика от съобщение към комит с твърд формат или конфигурационен файл с точен синтаксис, коментарът в ревю е просто начинът, по който бихте обяснили проблема на глас. „Това ще опитва до безкрай, ако сокетът така и не отговори; сложи горна граница.“ Изговореният и написаният вариант са почти еднакви.

Случва се, докато очите ви са заети. Четете диф. В мига, в който спрете, за да пишете, губите мястото си в него. Диктуването ви позволява да продължите да четете и да изговорите коментара в полето, в което вече сте кликнали.

Добавете и езиковото измерение. Ако екипът ви ревюира на полски, инструмент за диктуване само на английски ви налага избор: да ревюирате на английски (неестествено, а и колегите ви може да четат по-бавно) или да пишете (и да загубите ползата). Нито едното не е това, което искахте.

Какво поддържа Keebye в действителност

Тук значение имат два двигателя на устройството и си струва да бъдем точни за тях.

Двигателят по подразбиране е настроен за английски. Бърз е, той е този, който повечето хора използват, и не е този, който искате за коментар в ревю на полски. Насочен към реч, различна от английската, той ще произведе фонетично правдоподобен английски, който не е това, което сте казали.

Вторият двигател, Canary, покрива точно 25 езика: български, хърватски, чешки, датски, нидерландски, английски, естонски, фински, френски, немски, гръцки, унгарски, италиански, латвийски, литовски, малтийски, полски, португалски, румънски, руски, словашки, словенски, испански, шведски и украински. Той е по избор, сваля се веднъж и след това работи офлайн като всичко останало в Keebye. Не сто езика; двайсет и пет, изброени, и ако вашият не е в списъка, тази статия още не може да ви помогне.

Има и възможност за двигател да се използва вграденото разпознаване на реч на Apple, което носи собственото си езиково покритие на вашия Mac. Това е отделен път с различни характеристики; останалата част от статията е за Canary.

Фиксирайте езика; не го оставяйте да гадае

Най-важната настройка за ревю на език, различен от английския, е фиксирането на езика.

Автоматичното разпознаване звучи като правилната настройка по подразбиране и е погрешната за разработчици. Коментарите в ревю са наситени с английски идентификатори: имена на функции, имена на пакети, думите „null“, „async“ и „callback“. Коментар, който е осемдесет процента румънски и двайсет процента английски токени, дава на езиковия детектор точно смесения сигнал, с който той се справя най-зле. Ще превключи по средата на изречението или ще реши, че всичко е било английски, и ще получите транскрипция, която е уверено грешна. Фиксирайте езика на диктуване разглежда провала в детайли.

С Canary Keebye ви позволява да зададете езика изрично. Фиксирайте румънски и моделът декодира румънски; английските идентификатори в изречението ви се обработват като заемки, а не като доказателство, че сте сменили езика. Разпознаването на необичаен идентификатор пак може да е несъвършено, но самият език престава да е хвърляне на монета.

Една подробност в поведението, която си струва да знаете: фиксираният език се отчита за следващото изказване. Смените ли фиксирането, диктуването, което тепърва ще направите, го използва; онова, което вече сте пуснали, не се транскрибира наново. На практика това значи: първо превключете, после говорете. Ако през деня ревюирате на два езика, превключването е евтино. Иконата в лентата с менюта показва кратък списък от 11 езика за бърза смяна, а Настройките показват всичките 25.

Една сесия на ревю, продиктувана

Ето как изглежда сесия в екип, който ревюира на румънски.

Отваряте пул реквеста. Иконата вече показва фиксиран румънски от вчера, така че няма какво да правите. Прочитате първия файл. Трети хънк, цикъл за повторни опити без горна граница. Кликвате в полето за коментар, задържате десния Command, изговаряте коментара на румънски, пускате. Текстът се появява, с махнати „ъъ“ и един фалстарт от базираното на правила почистване, а идентификаторът reconnectSocket е непокътнат, защото го добавихте в собствения речник преди седмица.

Следващ файл. Коментарът, който искате да оставите, е предложение за код, не проза. Него го пишете; диктуването на диф е лошо преживяване на всеки език.

По-късно сътрудник от друг екип се включва в нишката и пише на английски. Искате да отговорите на английски. Кликвате иконата, избирате английски от краткия списък и следващото изказване се декодира като английски. Отговаряте, после превключвате обратно.

Нищо от това не изисква прозорец. Keebye стои в лентата с менюта; клавишната комбинация работи в приложението, което е на фокус — независимо дали това е раздел в браузъра с ревюто, десктоп клиент за Git или терминал с инструмент за ревю от командния ред.

Честни ограничения

Двайсет и пет езика, не всички. Ако ревюирате на турски, японски, арабски или на който и да е език извън списъка на Canary, вторият двигател не го покрива. Вграденият двигател на Apple може да го покрива, в зависимост от езиковата поддръжка на вашата система, но това е друг двигател с друго поведение.

Краткият списък в лентата е единайсет. Английски, румънски, френски, немски, испански, италиански, португалски, нидерландски, полски, руски и украински са на два клика. Останалите четиринайсет са в Настройките. Ако ежедневната ви двойка включва, да речем, чешки и фински, едната страна минава през Настройките.

Идентификаторите си остават идентификатори. Модел за реч на всеки език се затруднява с snake_case_names. Речникът помага за повтарящите се; останалите оправяте на ръка. Прочетете коментара, преди да го публикувате.

Няма транскрипция на живо. Canary транскрибира при пускане на клавиша, наведнъж. Няма да виждате думите, докато ги казвате. За коментар в ревю от едно до три изречения това едва се забелязва.

Изглаждането е по избор и по подразбиране е буквално. Ако включите изглаждането с локален LLM на устройството, то подрежда структурата на изреченията, а предпазителят за достоверност се връща към суровата транскрипция, когато резултатът показва тежка загуба, разрастване или повторение на токени. Този предпазител е евристика; той не проверява дали смисълът ви е оцелял. За коментари в ревю, където обърнато отрицание променя присъдата, повечето хора държат изглаждането изключено и оставят почистването по правила да си свърши работата.

Къде се вписва това

Ако фиксирането на езика е функцията, която ви интересува най-много, Keebye срещу Wispr Flow сравнява двете по това къде се изпълнява разпознаването и как се обработва езикът, включително къде Wispr Flow пасва по-добре. За по-широкия случай на диктуване, докато ръцете ви са върху дифа, ръководството за разработчици покрива ежедневието, а ръководството за Mac покрива настройката.

Допускането, че разработчиците са само англоезични, никога не е било вярно. Просто беше удобно за инструментите. Да ревюирате на своя език, с глас, с реч, която никога не напуска машината ви, не е нишово желание. Това е онова, което голяма част от хората, които пишат софтуер, биха правили, ако инструментите им позволяваха.