Cómo escribir un buen reporte de errores, con plantilla
Un buen reporte de errores permite a un desarrollador reproducir el problema sin hacer una sola pregunta. Esta guía explica qué incluir, le ofrece una plantilla para copiar y muestra los errores que hacen que los fallos sean difíciles de corregir.
¿Qué hace bueno a un reporte de errores?
Un buen reporte de errores es concreto, reproducible y completo. Describe un solo problema, explica cómo provocarlo, dice qué se esperaba en su lugar e incluye el entorno en el que ocurrió. Un desarrollador que lo lea puede abrir la página y ver el error en menos de un minuto.
Las ocho partes de un buen reporte de errores
- Título. Un breve resumen de qué falla y dónde. «Checkout: el botón Pagar no hace nada en móvil» es mejor que «Error en el checkout».
- Dirección de la página. La URL exacta en la que ocurre el problema.
- Pasos para reproducirlo. Pasos numerados desde un punto de partida conocido.
- Resultado esperado. Lo que debería haber ocurrido.
- Resultado real. Lo que ocurrió en su lugar, con el mensaje de error exacto si lo hay.
- Entorno. Navegador y versión, sistema operativo, dispositivo, tamaño de pantalla o de ventana, con o sin sesión iniciada, y el rol del usuario.
- Pruebas. Una captura de pantalla con el problema marcado o una breve grabación de pantalla para problemas de comportamiento.
- Detalles técnicos. Errores de consola y solicitudes de red fallidas, si puede obtenerlos.
Añada una prioridad si su equipo la usa, por ejemplo crítica (bloquea una función principal, sin alternativa), alta, normal o baja.
Plantilla de reporte de errores
Copie esta plantilla en su gestor de incidencias, correo electrónico o chat.
Title: [Area] - [what is wrong]
Page: https://
Steps to reproduce:
1.
2.
3.
Expected result:
Actual result:
Environment: [browser + version], [operating system], [device], [window size]
Logged in as: [role or "not logged in"]
Evidence: [screenshot / recording]
Console errors / failed requests: [if available]
Priority: [critical / high / normal / low]
Ejemplo
Title: Product page - price shows "12.9" without the euro sign
Page: https://shop.example/coffee/autumn-roast
Steps to reproduce:
1. Open the product page
2. Choose the 250 g variant
Expected result: the price shows "€12.90"
Actual result: the price shows "12.9"
Environment: Chrome 131, macOS 15, 1440 x 900 window
Logged in as: not logged in
Evidence: screenshot attached
Console errors: none
Priority: high (visible to every customer)
Errores habituales
- Varios problemas en un reporte. Se corrigen, prueban y cierran en momentos distintos; repórtelos por separado.
- Sin pasos. «No funciona» no se puede reproducir. Empiece desde una página conocida y enumere cada clic.
- Falta el entorno. Muchos errores de diseño solo ocurren con un tamaño de ventana o en un navegador concreto.
- Capturas de pantalla sin contexto. Marque el problema e incluya la barra de direcciones o la dirección de la página.
- Opiniones presentadas como hechos. «El azul es feo» es una solicitud de cambio, no un error. Diga qué le gustaría en su lugar.
Deje que una herramienta registre los detalles
Recoger a mano el entorno y los errores de consola es tedioso y fácil de olvidar. Una herramienta visual de reporte de errores los registra automáticamente. Con mumus, quien reporta hace clic en el elemento que falla y escribe el título, los pasos y el resultado esperado; la captura de pantalla, la dirección de la página, el navegador, el tamaño de ventana, los errores de consola y las solicitudes fallidas se añaden automáticamente.
Preguntas frecuentes
¿Qué debe incluir un reporte de errores?
Un título claro, la dirección de la página, pasos numerados para reproducirlo, el resultado esperado y el real, el entorno (navegador, sistema operativo, dispositivo, tamaño de ventana, rol del usuario), una captura o grabación de pantalla y, si están disponibles, los errores de consola o las solicitudes de red fallidas.
¿Cómo se escriben los pasos para reproducir un error?
Parta de un estado conocido, como la dirección de una página y si tiene la sesión iniciada, y enumere cada acción como un paso numerado hasta que aparezca el problema. Pruebe usted mismo los pasos una vez antes de enviar el reporte.