Dicter vos revues de code dans votre propre langue

Il y a une hypothèse discrète intégrée à la plupart des outils de développement : le code est en anglais, donc le développeur doit l’être aussi. Les mots-clés sont anglais. Les noms de bibliothèques sont anglais. Les messages d’erreur sont anglais. Et donc, suit le raisonnement, la dictée pour les développeurs peut être réservée à l’anglais et personne n’y trouvera rien à redire.

La revue de code casse cette hypothèse immédiatement. Un commentaire de revue n’est pas du code. C’est une phrase adressée à une personne, et dans un très grand nombre d’équipes, cette personne partage votre première langue. Une équipe roumaine qui relit un service Rust écrit des commentaires en roumain à propos d’identifiants anglais. Une équipe polonaise fait la même chose en polonais, une équipe allemande en allemand. Le code reste en anglais ; la conversation à propos du code, non.

La dictée est particulièrement bonne pour les commentaires de revue, parce que relire est une activité de lecture et que taper interrompt la lecture. Mais elle n’est bonne que si elle fonctionne dans la langue dans laquelle le commentaire est réellement écrit. Cet article explique comment y arriver : quelles langues Keebye couvre sur l’appareil, comment se comporte l’épinglage de la langue, et où sont les bords. Si vous voulez l’argumentaire de fond, la dictée pour les développeurs ne devrait pas être réservée à l’anglais s’en charge ; ceci en est la suite pratique.

Pourquoi les commentaires de revue sont la cible idéale de la dictée

Un commentaire de revue a trois propriétés qui le rendent plus adapté à la voix que presque n’importe quel autre texte de développeur.

Il est court. La plupart des commentaires font une à trois phrases. C’est un souffle, un appui maintenu sur le raccourci, un énoncé.

C’est de la prose. Contrairement à un message de commit au format rigide ou à un fichier de config à la syntaxe exacte, un commentaire de revue est simplement la façon dont vous expliqueriez le problème à voix haute. « Ça réessaie indéfiniment si la socket ne répond jamais ; plafonne-le. » Les versions parlée et tapée sont presque identiques.

Il arrive pendant que vos yeux sont occupés. Vous lisez un diff. Au moment où vous vous arrêtez pour taper, vous perdez votre place dedans. La dictée vous laisse continuer à lire et parler le commentaire dans le champ où vous avez déjà cliqué.

Ajoutez maintenant la dimension de la langue. Si votre équipe fait ses revues en polonais, un outil de dictée réservé à l’anglais impose un choix : relire en anglais (peu naturel, et vos collègues le lisent peut-être plus lentement) ou taper (en perdant le bénéfice). Ni l’un ni l’autre n’était ce que vous voulez.

Ce que Keebye prend réellement en charge

Deux moteurs sur l’appareil comptent ici, et il vaut la peine d’être exact à leur sujet.

Le moteur par défaut est réglé pour l’anglais. Il est rapide, c’est celui que la plupart des gens utilisent, et ce n’est pas celui que vous voulez pour un commentaire de revue en polonais. Pointé vers de la parole non anglaise, il produira de l’anglais phonétiquement plausible qui n’est pas ce que vous avez dit.

Le second moteur, Canary, couvre exactement 25 langues : bulgare, croate, tchèque, danois, néerlandais, anglais, estonien, finnois, français, allemand, grec, hongrois, italien, letton, lituanien, maltais, polonais, portugais, roumain, russe, slovaque, slovène, espagnol, suédois et ukrainien. Il est optionnel, il se télécharge une fois, et après ça il tourne hors ligne comme tout le reste dans Keebye. Pas cent langues ; vingt-cinq, listées — et si la vôtre n’y est pas, cet article ne peut pas encore vous aider.

Il y a aussi l’option d’utiliser la reconnaissance vocale native d’Apple comme moteur, qui apporte sa propre couverture linguistique sur votre Mac. C’est un chemin distinct avec des caractéristiques différentes ; le reste de cet article porte sur Canary.

Épinglez la langue ; ne la laissez pas devinée

Le réglage le plus important pour les revues non anglophones, c’est l’épinglage de la langue.

La détection automatique a l’air du bon réglage par défaut et c’est le mauvais pour des développeurs. Les commentaires de revue sont denses en identifiants anglais : noms de fonctions, noms de paquets, les mots « null », « async » et « callback ». Un commentaire à quatre-vingts pour cent en roumain et à vingt pour cent en tokens anglais donne à un détecteur de langue exactement le signal mixte qu’il gère le moins bien. Il basculera en milieu de phrase, ou décidera que tout était de l’anglais, et vous obtiendrez une transcription qui a tort avec assurance. Épinglez votre langue de dictée détaille la panne.

Avec Canary, Keebye vous laisse fixer la langue explicitement. Épinglez le roumain et le modèle décode du roumain ; les identifiants anglais à l’intérieur de votre phrase sont traités comme des emprunts plutôt que comme la preuve que vous avez changé de langue. La reconnaissance d’un identifiant inhabituel peut rester imparfaite, mais la langue elle-même cesse d’être un lancer de pièce.

Un détail de comportement à connaître : la langue épinglée est lue pour l’énoncé suivant. Changez l’épinglage et la dictée que vous êtes sur le point de faire l’utilise ; celle que vous avez déjà relâchée n’est pas retranscrite. En pratique cela veut dire : basculez, puis parlez. Si vous faites vos revues dans deux langues au cours de la journée, la bascule est bon marché. La barre des menus expose une liste courte de 11 langues pour changer rapidement, et les Réglages exposent les 25.

Une session de revue, dictée

Voici à quoi ressemble une session dans une équipe qui fait ses revues en roumain.

Vous ouvrez la pull request. La barre des menus montre déjà le roumain épinglé depuis hier, donc rien à faire. Vous lisez le premier fichier. Troisième bloc, une boucle de retry sans plafond. Cliquez dans le champ de commentaire, maintenez Right ⌘, dites le commentaire en roumain, relâchez. Le texte atterrit, avec un « euh » et un faux départ retirés par le nettoyage à base de règles, et l’identifiant reconnectSocket intact parce que vous l’avez ajouté au dictionnaire personnalisé il y a une semaine.

Fichier suivant. Le commentaire que vous voulez laisser est une suggestion de code, pas de la prose. Celui-là, vous le tapez ; dicter un diff est une mauvaise expérience dans n’importe quelle langue.

Plus tard, un contributeur d’une autre équipe rejoint le fil et écrit en anglais. Vous voulez répondre en anglais. Cliquez sur la barre des menus, choisissez l’anglais dans la liste courte, et l’énoncé suivant est décodé comme de l’anglais. Répondez, puis rebasculez.

Rien de tout cela n’a besoin d’une fenêtre. Keebye reste dans la barre des menus ; le raccourci fonctionne dans l’app qui a le focus, que ce soit un onglet de navigateur avec la revue, un client Git de bureau ou un terminal exécutant un outil de revue en CLI.

Les limites honnêtes

Vingt-cinq langues, pas toutes. Si vous faites vos revues en turc, en japonais, en arabe ou dans une langue hors de la liste Canary, le second moteur ne la couvre pas. Le moteur natif d’Apple le fait peut-être, selon la prise en charge linguistique de votre système, mais c’est un moteur différent avec un comportement différent.

La liste courte de la barre des menus fait onze. Anglais, roumain, français, allemand, espagnol, italien, portugais, néerlandais, polonais, russe et ukrainien sont à deux clics. Les quatorze autres sont dans les Réglages. Si votre paire quotidienne inclut, disons, le tchèque et le finnois, un côté passera par les Réglages.

Les identifiants restent des identifiants. Un modèle vocal, dans n’importe quelle langue, souffre avec les snake_case_names. Le dictionnaire aide pour ceux qui reviennent souvent ; le reste se corrige à la main. Relisez le commentaire avant de le publier.

Pas de transcription en direct. Canary transcrit au relâchement de la touche, en un seul lot. Vous ne verrez pas les mots pendant que vous les dites. Pour un commentaire de revue d’une à trois phrases, c’est à peine perceptible.

Le polissage est optionnel et littéral par défaut. Si vous activez le polissage par LLM local sur l’appareil, il range la structure des phrases et un garde-fou de fidélité revient à la transcription brute quand la sortie montre une perte de tokens sévère, une expansion ou une répétition. Ce garde-fou est une heuristique ; il ne vérifie pas que votre sens a survécu. Pour les commentaires de revue, où une négation inversée change le verdict, la plupart des gens gardent le polissage désactivé et laissent le nettoyage à base de règles faire le travail.

Où cela s’inscrit

Si l’épinglage de la langue est la fonctionnalité qui vous importe le plus, Keebye vs Wispr Flow compare les deux sur l’endroit où tourne la reconnaissance vocale et sur la façon dont la langue est gérée, y compris là où Wispr Flow convient mieux. Pour le cas plus large de la dictée avec les mains sur le diff, le guide pour les développeurs couvre le quotidien, et le guide Mac couvre l’installation.

L’hypothèse selon laquelle les développeurs sont anglophones exclusifs n’a jamais été vraie. Elle était juste commode pour les outils. Faire ses revues dans sa propre langue, à la voix, avec une reconnaissance vocale qui ne quitte jamais votre machine, n’est pas une demande de niche. C’est ce que ferait une grande partie des gens qui écrivent du logiciel si les outils le permettaient.