Cómo grabar un video para reportar un bug que el equipo pueda resolver
Respuesta corta: reproduce el bug una vez antes de grabar. Luego, en Director, elige una pantalla entera, pulsa CtrlAltP, di qué esperabas y qué pasó, y pon un foco sobre el error cuando aparezca. Adjunta el MP4 al ticket junto con los pasos escritos, porque el video no reemplaza el texto.
Qué debe mostrar un buen video de bug
Un video de bug sirve cuando quien lo recibe puede repetir lo que hiciste. Muestra estas cinco cosas, en este orden:
- El punto de partida. La página, la pantalla o la cuenta donde empezaste, para que quien lo revisa llegue al mismo lugar.
- Los pasos exactos. Cada clic y cada campo que llenaste, en el orden en que los hiciste.
- Lo esperado y lo que pasó. Qué debía ocurrir y qué ocurrió en realidad.
- El mensaje de error. Si la app muestra uno, que se quede en pantalla el tiempo suficiente para leerlo.
- El entorno. El navegador y su versión, la versión de la app y el tipo de cuenta, como administrador o plan gratis.
Trata de que el video dure menos de dos minutos cuando puedas. Es un consejo, no una regla. Un clip corto que empieza justo antes del error es más fácil de revisar que uno largo en el que hay que buscar el momento.
Antes de grabar
Prepara la pantalla para que el video muestre el bug y nada más.
- Reproduce el bug una vez. Haz los pasos antes de grabar, para conocer el camino exacto y confirmar que todavía falla.
- Borra los datos de prueba. Quita lo que dejó tu intento anterior, para que el primer paso empiece igual cada vez.
- Cierra pestañas privadas y notificaciones. El correo, el chat y las pestañas personales no deben aparecer en el video.
- Usa una cuenta de prueba. Nunca metas datos reales de un cliente en un video ni en un ticket.
- Abre la consola si el bug está en una web. En Chrome o Edge, pulsa F12 y abre la pestaña Console antes de empezar, para que cualquier error en rojo esté listo cuando aparezca.
- Anota la versión de la app. Búscala antes de empezar y escríbela, porque el ticket la necesita.
Graba el video con Director
- Haz clic en Choose what to record y elige una pantalla entera, no una sola ventana. El zoom solo puede seguir tu cursor en una pantalla entera.
- Activa el micrófono en Director si quieres narrar. Déjalo apagado si prefieres escribir la explicación.
- Pulsa CtrlAltP para empezar.
- Antes de cada paso, di qué esperas que pase. Por ejemplo: “Espero que el botón Guardar cierre el diálogo.”
- Haz los pasos despacio. Lleva el cursor sobre cada objetivo antes de hacer clic y quédate un momento encima.
- Cuando ocurra el bug, pulsa CtrlAltN en ese instante para dejar un marcador.
- Pulsa CtrlAltS para poner un foco sobre el error en pantalla. Pulsa CtrlAltD para quitarlo.
- Si el mensaje de error es pequeño, pon el cursor encima y pulsa CtrlAltZ para hacer zoom. Pulsa CtrlAltX para alejar. La guía de zoom explica los niveles de zoom.
- Deja el error en pantalla unos segundos para que se pueda leer, y pulsa CtrlAltP para parar. El MP4 queda guardado en tu carpeta Videos, dentro de Director.
Director no recorta el video. Si cometes un error grande, para y graba la toma otra vez, que es rápido porque la toma es corta. Si necesitas un momento para devolver la pantalla a su punto de partida, pulsa CtrlAltJ para pausar. El video continúa sin hueco cuando vuelves a pulsarlo.
Marca el momento exacto
Cuando paras, Director muestra la lista de tus marcadores con su tiempo, en el mismo formato que los capítulos de YouTube, por ejemplo 01:12 Chapter 3. Copia el tiempo del marcador del bug y ponlo en el ticket, por ejemplo: bug en 01:12.
Eso le dice a quien revisa dónde mirar en el video. No reemplaza los pasos.
Escribe el ticket junto al video
Director guarda el MP4 en tu PC. No lo sube ni crea un enlace, así que tú adjuntas el archivo al ticket en Jira, GitHub issues, Linear o la herramienta que use tu equipo. Luego escribe el texto del ticket:
- Título: el bug en una línea, con la pantalla o la función donde ocurre.
- Pasos: numerados, desde el punto de partida.
- Esperado: lo que debía pasar.
- Actual: lo que pasó, con el mensaje de error copiado como texto.
- Entorno: navegador y versión, versión de la app y tipo de cuenta.
- Video: el nombre del archivo y el tiempo del marcador, como bug en 01:12.
El video no reemplaza los pasos escritos. La búsqueda encuentra palabras, no lo que pasa en la pantalla, así que quien busque un mensaje de error necesita que esté escrito en el ticket.
Revisiones de código y recorridos también
El mismo método sirve para mostrarle a un compañero un pull request o explicarle un cambio. Abre el diff en el navegador, graba una pantalla entera y pulsa CtrlAltZ sobre la línea de código que estás comentando. Luego pulsa CtrlAltS para poner un foco sobre esa línea, y CtrlAltN para marcarla en la lista de tiempos.
Guías relacionadas
Para hacer zoom sobre el error mientras grabas, lee cómo hacer zoom en una grabación de pantalla en Windows. Para dejar fuera del video una carga lenta, lee cómo pausar una grabación de pantalla en Windows. Para ver todos los atajos juntos, mira atajos para grabar la pantalla en Windows.