Dictado en incidencias de GitHub en un Mac

Los cuerpos de las incidencias son prosa: qué falló, qué esperabas, qué viste. El dictado encaja bien. La complicación es que el cuadro de comentarios de GitHub está conectado con el resto de la plataforma, así que dos caracteres hablados tienen consecuencias fuera del texto.

La trampa propia de GitHub: un «at» dictado avisa a alguien

Escribir «@» en el cuerpo de una incidencia abre el autocompletado de menciones de usuarios. Si dices «at» mientras dictas una dirección de correo, un nombre de usuario o la frase «at the same time», el selector se abre sobre tu texto. Peor aún, si la siguiente palabra dictada coincide con un nombre de usuario y pulsas Retorno, GitHub inserta una mención real. Al publicar esa mención se envía una notificación a un desconocido que ahora tiene tu informe de error en su bandeja de entrada.

• Pulsa Escape para cerrar el selector antes de seguir dictando.
• Antes de enviar, busca en la vista previa enlaces azules con @ que no querías. La pestaña de vista previa muestra las menciones como enlaces, lo que las hace fáciles de detectar.
• Lo mismo vale para un «hash» o «number sign» dictado, que abre el selector de incidencias y pull requests y puede enlazar una incidencia que no tiene nada que ver.

La segunda trampa: Comando+Retorno envía

Comando+Retorno publica el comentario. Un atajo de dictado basado en Comando puede enviar una incidencia a medio dictar a un repositorio público. Asigna el dictado a una tecla que no incluya Comando, o redacta en un archivo temporal y pega.

Dicta una incidencia

1. Activa el Dictado una vez: Ajustes del Sistema → Teclado → Dictado. Pasos completos en activa el dictado en macOS.
2. Abre el formulario de nueva incidencia y haz clic en el campo del cuerpo. El título es un campo aparte y no admite navegación por voz.
3. Dicta la prosa de una sola vez, siguiendo la estructura de abajo.
4. Detente y luego teclea lo que la voz transcribe mal: rutas de archivo, identificadores, cadenas de versión y todo lo que deba ir en un bloque de código.
5. Abre la pestaña de vista previa y léela antes de enviar.

Una estructura que se dicta bien

El dictado premia una forma que puedas tener en la cabeza mientras hablas. Esta no lleva formato hasta la pasada de edición:

1. Una frase que diga qué falló.
2. Los pasos, dichos como una secuencia: primero, luego, luego.
3. Lo que esperabas y después lo que ocurrió en realidad. Dos frases.
4. El entorno: versión del sistema operativo, versión de la app, navegador.
5. Lo que ya has descartado. Es la parte que más valoran los revisores y la que la gente se salta al teclear.

Si no se escribe nada

• GitHub 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 foco sale del cuadro de comentarios, los atajos de una sola tecla de GitHub toman el control y las letras dictadas empiezan a activar la navegación.
• Si el dictado no funciona en ningún sitio, no solo en GitHub: el dictado no funciona en Mac.

Un atajo para el editor y el navegador

Voice Type inserta el texto terminado al soltar en lugar de enviar pulsaciones sueltas, así que los selectores de menciones e incidencias nunca se abren a media frase, y el mismo atajo funciona en el editor donde encontraste el error: escritura por voz para Mac.

Sigue leyendo

• Dictar descripciones de pull requests en GitHub
• Dictado en Linear (el menú de barra diagonal y el borrador que se guarda con Escape)
• Escritura por voz en VS Code

Fuentes

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