KjerrUna plantilla de bug report
que puedes copiar.
Una buena plantilla de bug report (reporte o informe de errores) lleva a un desarrollador de leer a reproducir de una sola pasada: qué pasó, qué se esperaba, los pasos y dónde. Copia la plantilla de abajo en un documento, un formulario o un gestor de incidencias, o crea los mismos campos en un tablero que además admita los archivos.
La plantilla de bug report
Siete preguntas. Exige el título y los pasos; deja lo demás como opcional.
Título
Qué falla y dónde. Una línea.
Ejemplo: La exportación a CSV descarga un archivo vacío
¿Qué pasó?
Lo que viste, en una o dos frases.
¿Qué esperabas?
Lo que debería haber pasado.
Pasos para reproducirlo
1.
2.
3.
¿Con qué frecuencia?
Siempre, a veces o una sola vez.
¿Dónde?
Navegador o versión de la aplicación, sistema operativo, cuenta o espacio de trabajo.
¿Tienes algo que mostrar?
Una captura de pantalla, una grabación de pantalla, un log, un archivo HAR.
Un ejemplo de bug report
La misma plantilla, rellenada. El producto y las cifras son inventados.
Título
La exportación a CSV descarga un archivo vacío
¿Qué pasó?
Hice clic en Exportar en la página Informes. Se descargó
un archivo, pero solo tiene la fila de encabezados.
¿Qué esperabas?
Las 214 filas que muestra la tabla en pantalla.
Pasos para reproducirlo
1. Abre Informes y elige los últimos 30 días.
2. Filtra por el plan “Scale”.
3. Haz clic en Exportar y luego en CSV.
¿Con qué frecuencia?
Siempre que el filtro está activo. Sin él, la exportación va bien.
¿Dónde?
Chrome 141 en macOS 15. Espacio de trabajo: northwind.
¿Tienes algo que mostrar?
export.csv (el archivo vacío), reports.har
Para qué sirve cada campo
- Título. Qué falla y dónde, para que el bug report se pueda volver a encontrar y los duplicados se junten.
- ¿Qué pasó? El síntoma en palabras de quien lo vio, antes de que nadie lo interprete.
- ¿Qué esperabas? La mitad de los bug reports son un malentendido, y esta línea muestra de qué mitad se trata.
- Pasos para reproducirlo. La parte que un desarrollador no puede adivinar. Numerados, una acción en cada uno.
- ¿Con qué frecuencia? “Siempre” apunta a la lógica; “a veces”, a los tiempos o a los datos.
- ¿Dónde? El navegador, la versión y la cuenta acotan la búsqueda más que cualquier descripción.
- ¿Tienes algo que mostrar? Una grabación o un log sustituyen a tres párrafos.
Cómo convertir la plantilla en un formulario de reporte de errores
Un formulario de reporte de errores debería pedir menos que la plantilla. Cada campo obligatorio hace que se pierdan algunos avisos, y un aviso que no llega sale más caro que un detalle que falta.
- Exige el título y los pasos para reproducirlo, nada más.
- Pon un ejemplo en el texto de ayuda de cada campo, para que se vea el nivel de detalle que esperas.
- Muestra los avisos parecidos antes de que se envíe el formulario, para que la gente sume un voto y no un duplicado.
- Deja adjuntar archivos con solo arrastrarlos al formulario.
- Di qué pasa después: dónde aparecerá el aviso y cómo llegará la respuesta.
Qué adjuntar a un informe de errores
Las pruebas acortan la conversación. Estos son los archivos que vale la pena pedir, y qué aclara cada uno.
- Una captura de pantalla, para todo lo visual.
- Una grabación de pantalla en MP4, cuando los pasos son difíciles de explicar con palabras.
- Un archivo HAR, cuando una página no carga, no guarda o no exporta.
- Un log de la consola o del servidor, en TXT o LOG.
- El propio correo en EML, para los problemas de entrega y de formato.
- El archivo CSV, XLSX o JSON que no se dejó importar, o el que salió mal.
Cómo recoger bug reports en un tablero de Kjerr
Un tablero de Kjerr puede hacer las preguntas de la plantilla y guardar las pruebas. La herramienta de gestión de feedback que tiene detrás le muestra al equipo qué hay de nuevo.
- El formulario se edita: añade “Pasos para reproducirlo”, “Qué esperabas” y “Dónde” como campos propios, hasta 10 campos en total, cada uno obligatorio u opcional y con su texto de ayuda.
- Hasta 5 archivos de 10 MB en un bug report o en un comentario: imágenes, PDF, EML, TXT, LOG, CSV, JSON, HAR, ZIP, DOCX, XLSX, PPTX y MP4.
- Los avisos parecidos aparecen mientras se escribe el título, cada uno con su botón de voto.
- Para un tablero de QA, ponlo en modo solo para miembros y limita el inicio de sesión al dominio de correo de tu empresa: la misma configuración que un buzón de sugerencias digital.
- Cuando el estado pasa a Shipped, quien avisó del error y todos los que votaron reciben un correo.
- No es un gestor de incidencias: no hay responsables asignados, niveles de gravedad ni sprints.
Preguntas con respuestas claras.
¿Qué es una plantilla de bug report?
Una plantilla de bug report, o de reporte de errores, es un conjunto fijo de preguntas que saca los mismos datos de cada aviso: qué pasó, qué se esperaba, los pasos para reproducirlo y dónde ocurrió. Permite que un desarrollador pase de leer a reproducir sin una ronda de preguntas.
¿Qué debe incluir un bug report?
Un título de una línea, qué pasó, qué se esperaba, los pasos numerados para reproducirlo, con qué frecuencia ocurre, el entorno y pruebas como una captura de pantalla o un log. Si solo se pueden exigir dos cosas, que sean el título y los pasos.
¿Qué diferencia hay entre un bug report y un feature request?
Un bug report dice que el producto no hace lo que promete. Un feature request pide algo que nunca prometió. Necesitan preguntas distintas; para el segundo, usa la plantilla de feature request.
¿Cómo se escriben unos buenos pasos para reproducir un error?
Empieza desde un estado al que cualquiera pueda llegar, escribe una acción por línea e incluye los valores exactos que escribiste o elegiste. Detente en el paso en el que aparece el problema. Si un paso a veces hace falta y a veces no, dilo.
¿Qué es un archivo HAR y conviene adjuntarlo?
Un archivo HAR es un registro de las peticiones que hizo una página web, guardado desde las herramientas para desarrolladores del navegador. Adjúntalo cuando una página no cargue, no guarde o no exporte. Revísalo antes: puede contener cookies de sesión y datos personales.
¿Kjerr puede sustituir a un gestor de incidencias?
No. Kjerr recoge los avisos de errores, quita los duplicados y avisa a quienes los enviaron cuando cambia el estado. No tiene responsables asignados, niveles de gravedad ni sprints, y tampoco sincronización con Jira o Linear. Los equipos lo usan como puerta de entrada y mantienen detrás su gestor de incidencias.
Páginas relacionadas
Dales una respuesta a tus usuarios.
Kjerr es gratis durante el acceso anticipado: todas las funciones, sin tarjeta de crédito. Cuando lleguen los planes de pago, se cobrarán por espacio de trabajo, nunca por licencia de administrador.