Dictado en Jira en un Mac

Jira no tiene función de dictado. Lo que tiene es un editor que reescribe tu texto mientras lo dices y un conjunto de atajos de una sola tecla esperando al otro lado del límite del campo.

La trampa propia de Jira: el editor autoformatea a mitad de frase

El editor de Atlassian convierte markdown mientras lo escribes, lo que significa que lo convierte mientras lo dictas. Estas son las conversiones que afectan al habla dictada:

• Si dictas slash, se abre el menú de inserción, y las palabras que siguen filtran ese menú en lugar de entrar en la descripción. Pulsa Escape para cerrarlo.
• Si dictas asterisk o hyphen seguido de un espacio, se inicia una lista con viñetas, y cada salto de línea hablado después añade otra viñeta.
• Si dictas hash seguido de un espacio, la línea se convierte en un encabezado.
• Si dictas number, period, space, la línea se convierte en una lista numerada, por eso dictar una versión como "1. 2. 3" produce una lista en lugar de una cadena de versión.

Command+Z justo después de una conversión no deseada revierte el formato sin borrar las palabras.

La segunda trampa: las letras sueltas son comandos de Jira

Jira Cloud asigna acciones a teclas sueltas, entre ellas "c" para crear una incidencia. Dentro del campo de descripción esas teclas son solo caracteres. Fuera de él son comandos, así que un dictado que empieza antes de que el campo tenga el foco abre un cuadro de diálogo de creación de incidencia a mitad de tu primera frase. Confirma que el cursor de texto parpadea dentro de la descripción antes de hablar.

Dictar un ticket

1. Activa el dictado una sola vez: Ajustes del Sistema → Teclado → Dictado. Los pasos completos están en cómo activar el dictado en macOS.
2. Abre la incidencia y haz clic en el campo de descripción. El resumen, el responsable y los campos estructurados son controles independientes y no admiten navegación por voz.
3. Dicta el cuerpo de una sola vez. Di "comma" y "period"; evita "slash", "asterisk" y "hash".
4. Detente y luego escribe las partes en las que el habla falla: claves de incidencias, enlaces, cadenas de versión y fragmentos de registros.
5. Aplica el formato al final, con la barra de herramientas y no por voz.

Una estructura que sobrevive a ser dicha en voz alta

1. El resumen en una frase, desde el lado del usuario.
2. El contexto: por qué se hace ahora, no qué debe hacer el código.
3. Pasos para reproducirlo, dichos como una secuencia.
4. Resultado esperado y luego resultado real. Dos frases.
5. Criterios de aceptación, dichos como frases normales y con formato de lista de comprobación después.

Si no se escribe nada

• Jira Cloud se ejecuta en un navegador, así que el permiso del micrófono pertenece al navegador y a la herramienta de dictado, en Ajustes del Sistema → Privacidad y seguridad → Micrófono.
• Si el texto dictado desaparece al guardar, la descripción seguía en estado sin guardar en el editor cuando el foco se movió. Haz clic en "Save" antes de cambiar de ventana.
• Si el dictado no funciona en ningún sitio, no solo en Jira: el dictado no funciona en Mac.

Un atajo que inserta de una vez en lugar de enviar teclas

Voice Type escribe la puntuación a partir del audio e inserta el pasaje terminado al soltar la tecla, lo que no da al editor un flujo de caracteres que autoformatear, y el mismo atajo funciona en la rama, en el pull request y en el mensaje de la reunión diaria: dictado por voz para Mac.

Sigue leyendo

• Dictado en Linear (el mismo menú de barra, otro editor)
• Dictar issues de GitHub sin notificar a desconocidos

Fuentes

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