Diktieren in Jira am Mac

Jira hat keine Diktierfunktion. Es hat einen Editor, der deinen Text beim Sprechen umschreibt, und eine Reihe von Ein-Tasten-Kürzeln, die auf der anderen Seite der Feldgrenze warten.

Die Jira-Falle: Der Editor formatiert mitten im Satz automatisch

Der Editor von Atlassian wandelt Markdown um, während du tippst, und damit auch, während du diktierst. Diese Umwandlungen erwischen diktierte Sprache:

• Wenn du slash diktierst, öffnet sich das Einfügemenü, und die Wörter danach filtern dieses Menü, statt in die Beschreibung zu gelangen. Mit Escape schließt du es.
• Wenn du asterisk oder hyphen gefolgt von einem Leerzeichen diktierst, beginnt eine Aufzählung, und jeder weitere gesprochene Zeilenumbruch fügt einen neuen Aufzählungspunkt hinzu.
• Wenn du hash gefolgt von einem Leerzeichen diktierst, wird die Zeile zur Überschrift.
• Wenn du number, period, space diktierst, wird die Zeile zu einer nummerierten Liste. Deshalb ergibt das Diktieren einer Version wie "1. 2. 3" eine Liste statt einer Versionsangabe.

Command+Z unmittelbar nach einer ungewollten Umwandlung macht die Formatierung rückgängig, ohne die Wörter zu löschen.

Die zweite Falle: Einzelne Buchstaben sind Jira-Befehle

Jira Cloud belegt einzelne Tasten mit Aktionen, darunter "c" zum Erstellen eines Vorgangs. Im Beschreibungsfeld sind diese Tasten einfach Zeichen. Außerhalb sind sie Befehle. Wenn das Diktieren beginnt, bevor das Feld den Fokus hat, öffnet sich mitten in deinem ersten Satz ein Dialog zum Erstellen eines Vorgangs. Vergewissere dich, dass der Textcursor in der Beschreibung blinkt, bevor du sprichst.

Ein Ticket diktieren

1. Schalte die Diktierfunktion einmalig ein: Systemeinstellungen → Tastatur → Diktierfunktion. Alle Schritte findest du unter Diktierfunktion in macOS aktivieren.
2. Öffne den Vorgang und klicke in das Beschreibungsfeld. Zusammenfassung, Bearbeiter und die strukturierten Felder sind eigene Bedienelemente, zu denen du nicht per Sprache navigierst.
3. Diktiere den Text in einem Zug. Sag "comma" und "period", vermeide aber "slash", "asterisk" und "hash".
4. Beende das Diktieren und tippe dann die Teile, bei denen Sprache danebenliegt: Vorgangsschlüssel, Links, Versionsangaben und Log-Auszüge.
5. Formatiere zuletzt, mit der Symbolleiste statt per Sprache.

Eine Struktur, die das Sprechen übersteht

1. Die Zusammenfassung in einem Satz, aus Sicht des Nutzers.
2. Der Kontext: warum das jetzt gemacht wird, nicht was der Code tun soll.
3. Schritte zur Reproduktion, als Abfolge gesprochen.
4. Erwartetes Ergebnis, dann tatsächliches Ergebnis. Zwei Sätze.
5. Akzeptanzkriterien, als einfache Sätze gesprochen und danach zu einer Checkliste formatiert.

Wenn gar nichts getippt wird

• Jira Cloud läuft im Browser, deshalb gehört die Mikrofonberechtigung dem Browser und dem Diktierwerkzeug, unter Systemeinstellungen → Datenschutz & Sicherheit → Mikrofon.
• Wenn diktierter Text beim Speichern verschwindet, war die Beschreibung im Editor noch ungespeichert, als der Fokus gewechselt hat. Klicke auf "Save", bevor du das Fenster wechselst.
• Diktieren funktioniert überall nicht, nicht nur in Jira: Diktierfunktion funktioniert am Mac nicht.

Ein Kürzel, das einmal einfügt, statt Tasten zu streamen

Voice Type setzt die Satzzeichen anhand des Audios und fügt den fertigen Abschnitt beim Loslassen ein. Der Editor bekommt so keinen Zeichenstrom, den er automatisch formatieren könnte, und dasselbe Kürzel funktioniert im Branch, im Pull Request und in der Standup-Nachricht: Spracheingabe für den Mac.

Weiterlesen

• Diktieren in Linear (dasselbe Slash-Menü, ein anderer Editor)
• GitHub-Issues diktieren, ohne Fremde zu benachrichtigen

Quellen

• Atlassian Support: Markdown and keyboard shortcuts
• Atlassian Support: Use keyboard shortcuts
• Apple: Dictate messages and documents on Mac