Diktieren in GitHub-Issues auf dem Mac

Issue-Texte sind Fließtext: was kaputtging, was du erwartet hast, was du gesehen hast. Diktieren passt gut dazu. Kompliziert wird es, weil das Kommentarfeld von GitHub mit dem Rest der Plattform verdrahtet ist, sodass zwei gesprochene Zeichen Folgen außerhalb des Textes haben.

Die GitHub-spezifische Falle: Ein diktiertes „at“ benachrichtigt jemanden

Wenn du „@“ in einen Issue-Text tippst, öffnet sich die Autovervollständigung für Nutzererwähnungen. Sagst du „at“, während du eine E-Mail-Adresse, einen Handle oder die Wendung „at the same time“ diktierst, öffnet sich die Auswahl über deinem Text. Schlimmer noch: Wenn das nächste diktierte Wort zufällig zu einem Benutzernamen passt und du Return drückst, fügt GitHub eine echte Erwähnung ein. Wird sie abgeschickt, bekommt ein Fremder eine Benachrichtigung und hat deinen Fehlerbericht plötzlich im Posteingang.

• Drücke Escape, um die Auswahl zu schließen, bevor du weiterdiktierst.
• Suche vor dem Absenden in der Vorschau nach blauen @-Links, die du nicht wolltest. Der Vorschau-Tab stellt Erwähnungen als Links dar, sodass sie leicht auffallen.
• Dasselbe gilt für ein diktiertes „hash“ oder „number sign“, das die Auswahl für Issues und Pull Requests öffnet und ein fremdes Issue verlinken kann.

Die zweite Falle: Command+Return schickt ab

Command+Return veröffentlicht den Kommentar. Ein Diktier-Hotkey, der auf Command aufbaut, kann ein halb diktiertes Issue in ein öffentliches Repository absenden. Lege das Diktieren auf eine Taste ohne Command oder schreibe den Entwurf in eine Notizdatei und füge ihn ein.

Ein Issue diktieren

1. Schalte die Diktierfunktion einmal ein: Systemeinstellungen → Tastatur → Diktierfunktion. Alle Schritte findest du unter Diktierfunktion in macOS aktivieren.
2. Öffne das Formular für ein neues Issue und klicke in das Textfeld. Der Titel ist ein eigenes Feld und lässt sich nicht per Sprache ansteuern.
3. Diktiere den Fließtext in einem Durchgang und halte dich dabei an die Struktur unten.
4. Beende die Diktierfunktion und tippe dann die Teile, bei denen die Spracherkennung danebenliegt: Dateipfade, Bezeichner, Versionsnummern und alles, was in einen Codeblock gehört.
5. Öffne den Tab „Vorschau“ und lies den Text, bevor du ihn absendest.

Eine Struktur, die sich sauber diktieren lässt

Beim Diktieren hilft eine Form, die du beim Sprechen im Kopf behalten kannst. Diese hier kommt bis zum Bearbeitungsdurchgang ohne Formatierung aus:

1. Ein Satz, der sagt, was kaputtging.
2. Die Schritte, gesprochen als Abfolge: erst, dann, dann.
3. Was du erwartet hast, dann was tatsächlich passiert ist. Zwei Sätze.
4. Die Umgebung: Betriebssystemversion, App-Version, Browser.
5. Was du bereits ausgeschlossen hast. Das ist der Teil, den Reviewer am meisten schätzen und den Leute beim Tippen auslassen.

Wenn überhaupt nichts getippt wird

• GitHub läuft im Browser, deshalb gehört die Mikrofonberechtigung dem Browser und dem Diktier-Tool, unter Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon.
• Wenn der Fokus das Kommentarfeld verlässt, übernehmen die Einzeltasten-Kürzel von GitHub, und diktierte Buchstaben lösen Navigation aus.
• Diktieren funktioniert überall nicht, nicht nur in GitHub: Diktierfunktion funktioniert auf dem Mac nicht.

Ein Hotkey für Editor und Browser

Voice Type fügt den fertigen Text beim Loslassen ein, statt Tastenanschläge zu streamen. So öffnen sich die Auswahlen für Erwähnungen und Issues nie mitten im Satz, und derselbe Hotkey funktioniert im Editor, in dem du den Fehler gefunden hast: Spracheingabe für den Mac.

Weiterlesen

• Pull-Request-Beschreibungen auf GitHub diktieren
• Diktieren in Linear (das Slash-Menü und der Entwurf, der bei Escape gespeichert wird)
• Spracheingabe in VS Code

Quellen

• GitHub Docs: Basic writing and formatting syntax
• GitHub Docs: Keyboard shortcuts
• Apple: Dictate messages and documents on Mac