Un informe de error es un conjunto de instrucciones para reproducir algo que tú ya has visto. Ha funcionado cuando alguien que no estaba allí consigue provocar lo mismo en su primer intento, y ha fallado cuando esa persona tiene que volver a preguntarte algo.
Todo lo que sigue está escrito desde esa única prueba. Siete cosas que un informe tiene que responder, una plantilla que las pide en orden y un informe real reescrito a partir de la versión que habrían devuelto.
Si lo que buscas es el argumento de por qué fallan los informes y no los requisitos en sí, el artículo complementario sobre diez errores habituales al reportar bugs cubre las costumbres que más tiempo cuestan.
Qué tiene que responder un informe
El título
Un título se lee muchas veces y se abre una. Aparece en la búsqueda, en las reuniones diarias, en las notas de versión y en la lista que alguien repasa mientras elige qué coger. Escríbelo como lo que falló, más dónde o cuándo, más el detalle que separa tu caso del de todos los demás, a quienes les funciona.
- Débil
- El login no va
- Mejor
- El botón de acceso no responde tras introducir las credenciales en Firefox 121, Windows 11
Los pasos
Numéralos y empieza desde un estado al que cualquiera pueda llegar. No “entra en mi cuenta”, sino el acceso, los datos y cada acción en el orden en que la hiciste. Termina con lo que viste, para que quien lee sepa cuándo ha llegado.
1. Ir a https://example.com/login
2. Introducir el correo test@example.com y la contraseña TestPass123!
3. Pulsar Acceder
4. Observación: el botón muestra un breve estado de carga y vuelve a la normalidad. No navega.
Dáselos a alguien que no haya visto el error. Si te pregunta algo, la respuesta es tu paso que falta.
Comportamiento esperado y real
Escribe los dos. “El acceso no funciona” da por hecho que quien lee sabe cómo es que funcione, y a veces lo que estás reportando resulta ser una regla que no conocías.
- Esperado
- El usuario es redirigido a /dashboard tras un acceso correcto
- Real
- El botón carga durante un segundo aproximadamente, vuelve a su estado normal y la página no cambia
El entorno
Un defecto que ocurre en todas partes y un defecto que ocurre en un solo navegador tienen causas distintas, y nadie puede saber cuál es el tuyo hasta que alguien lo comprueba. Anota el navegador y su versión, el sistema operativo, el dispositivo y el tamaño de la ventana si el diseño está implicado.
El último Chrome no es una versión. Significa una cosa el día que lo escribes y otra el día que
se lee.
Pruebas visuales
Una captura de pantalla resuelve de golpe un problema de diseño o de texto. Una grabación es mejor para todo lo que implique tiempos, animación o una secuencia. Captura la ventana entera y no solo el rincón roto: la barra de direcciones, la consola y el resto de la página son a menudo donde está la respuesta.
La consola y la pestaña de red
Lo primero que pide alguien que programa y lo último que incluyen la mayoría de los informes. Abre las herramientas de desarrollo antes de cerrar la pestaña: F12, o Cmd
- Option + I en un Mac.
Copia el texto del error en lugar de fotografiarlo, para que se pueda buscar, y anota el estado y la ruta de cualquier petición que fallara.
POST https://example.com/api/auth/login 403 (Forbidden)
Error: Authentication failed: Invalid CSRF token
at login.js:45
El impacto
La prioridad no es lo mismo que tu urgencia, y un informe que no ofrece ninguna señal lo prioriza quien más grita. Da los hechos que permiten decidir a otra persona: a cuánta gente afecta, si hay dinero o datos de por medio, si existe una forma de esquivarlo y si antes funcionaba.
“Bloquea el acceso a todos los usuarios de Firefox, sin solución alternativa, empezó tras la publicación de esta tarde” es más alarmante que “urgente”, y es más probable que se coja hoy.
La plantilla
# Informe de error
## Título
[Título claro y descriptivo - qué está roto y dónde]
## Descripción
[Resumen breve del problema - 1-2 frases]
## Pasos para reproducirlo
1. [Primer paso - partiendo de un estado conocido]
2. [Segundo paso - concreta las acciones]
3. [Tercer paso - incluye los datos y valores usados]
4. [Pasos adicionales si hacen falta]
5. [Paso final que provoca el error]
## Comportamiento esperado
[Lo que debería ocurrir según el diseño o la lógica]
## Comportamiento real
[Lo que ocurre de verdad - describe los síntomas]
## Entorno
- **Navegador:** [Nombre y versión del navegador]
- **Sistema operativo:** [Sistema y versión]
- **Dispositivo:** [Escritorio o móvil y modelo]
- **Resolución de pantalla:** [Si es un problema de diseño]
- **Estado del usuario:** [Dentro o fuera de la sesión, rol]
## Pruebas visuales
[Adjunta capturas de pantalla o vídeo]
- Captura 1: [Descripción]
- Captura 2: [Descripción]
- Vídeo: [Enlace o adjunto]
## Errores de consola
```
[Pega los errores de la consola del navegador - F12 → pestaña Consola]
```
## Problemas de red
[Llamadas a la API fallidas desde la pestaña Red - F12 → Red]
## Impacto y gravedad
- **Gravedad:** [Crítica/Alta/Media/Baja]
- **Usuarios afectados:** [Todos / Usuarios móviles / Un rol concreto / etc.]
- **Impacto en el negocio:** [Ingresos perdidos / Carga de soporte / etc.]
- **Solución alternativa:** [Sí/No - si la hay, descríbela]
## Contexto adicional
- **Frecuencia:** [Siempre / A veces / Rara vez]
- **Desde cuándo:** [Ahora mismo / Tras una actualización / Desde [fecha]]
- **Incidencias relacionadas:** [Enlaces a errores parecidos]
- **Otras notas:** [Cualquier otra información relevante]
## Comprobaciones
- [ ] Lo he probado en un entorno limpio (modo incógnito o privado)
- [ ] He incluido los pasos para reproducirlo
- [ ] He dado los detalles del entorno
- [ ] He adjuntado capturas de pantalla o vídeo
- [ ] He mirado si hay errores en la consola
- [ ] He comprobado si ya se había reportado
El mismo error, reportado dos veces
La primera versión es la que suele llegar. La segunda es la misma persona, el mismo defecto, cuatro minutos después.
- Débil
- El login no va. No puedo entrar. ¡¡¡Arregladlo por favor!!!
- Mejor
- El botón de acceso no responde tras introducir las credenciales en Firefox 121, Windows 11
El segundo informe lleva todo lo demás: los cuatro pasos de arriba, el comportamiento esperado y el real, Firefox 121 en Windows 11 Pro a 1920x1080 en una ventana privada sin extensiones, dos capturas de pantalla y una grabación de quince segundos, el error de CSRF de la consola y una línea sobre la gravedad - todos los usuarios, sin solución alternativa, empezó tras el despliegue de las 14:30.
Nada de eso requirió investigación. Todo estaba en la pantalla mientras el error ocurría, y cada pieza desapareció en cuanto se cerró la pestaña.
De dónde sale el contexto
Mira lo que contiene el segundo informe. El título, los pasos y el comportamiento esperado son criterio, y son tuyos. El entorno, la captura, el error de consola y la petición fallida no son criterio en absoluto. Eran hechos sobre el navegador en el momento en que las cosas se torcieron, y anotarlos a mano significa salir de la página, buscar una cadena de versión y volver a teclear un error.
Session Replay
Extensión gratuita de Chrome. Un clic en la página que se está portando mal captura la captura de pantalla, la consola y el registro de red, y te devuelve un enlace para pegar en el ticket.
No escribirá tu título, ni decidirá tu gravedad, ni separará dos defectos en dos tickets. Esas son las partes que necesitan a alguien que estuvo allí.