Un error en algo que antes funcionaba: cómo reportar una regresión
Cómo reportar una regresión: encuentra la última versión que funcionaba, acota el intervalo hasta la primera que falló y dale al desarrollador un punto de partida.
«La semana pasada funcionaba.» Pocas frases despiertan tan rápido el interés de un desarrollador, y pocas son menos útiles por sí solas. Cuando una función que antes se comportaba bien deja de hacerlo, se habla de una regresión, y es un regalo para quien intenta corregirla, porque te dice algo valioso: el código estuvo bien en algún momento, así que la respuesta está en lo que cambió.
El problema es que «la semana pasada funcionaba» es una sensación, no un hecho. Para que sea útil tienes que convertirla en dos pruebas: la última vez que funcionó y la primera vez que no. Aquí verás cómo encontrarlas y cómo anotarlas.
Por qué vale la pena reportar bien las regresiones
Un error normal le pide al desarrollador que averigüe qué está mal. Una regresión le da ventaja. Si puedes decir «funcionaba en la compilación 2.13 y falla en la 2.14», la búsqueda se reduce de todo el producto a los cambios entre dos compilaciones. Un buen reporte de regresión puede convertir una investigación larga en una corta.
Paso uno: confirma que de verdad es una regresión
Antes de escribir «regresión» en el título, comprueba que el comportamiento anterior era real.
- ¿Funcionó alguna vez? Quizá la última vez seguiste otro camino, o había un indicador de función o un ajuste activado.
- ¿Es lo mismo? Una página que se parece a la antigua puede ser un flujo rediseñado con otra regla.
- ¿Cambiaron los datos? Una cuenta nueva o un archivo más grande pueden provocar algo que los datos antiguos no provocaban.
- ¿Era intencionado? A veces las notas de versión explican un cambio de comportamiento. Revísalas primero.
Si descubres que el cambio fue deliberado, puede que no sea un error, pero aun así vale la pena registrar, como pregunta, un reporte que cite la nota de versión.
Paso dos: encuentra la última versión buena
Si puedes ejecutar compilaciones antiguas, hazlo. Vuelve a una versión que recuerdes que funcionaba bien y ejecuta los mismos pasos.
- Si ahí funciona, tienes tu última compilación buena conocida.
- Si ahí también falla, retrocede más o replantéate si es una regresión.
- Si no puedes ejecutar compilaciones antiguas, busca pruebas: el resultado de un test, una captura de pantalla, un ticket de un cliente que la usó o un log de una ejecución correcta.
Escribe la versión o la compilación, no «hace un tiempo». Las fechas también ayudan, pero un número de compilación es exacto.
Paso tres: encuentra la primera versión mala
Ahora avanza desde la compilación buena y prueba las versiones intermedias. Cuando son muchas, no las pruebes una por una. Elige la del medio. Si funciona, el problema está después. Si falla, el problema está antes. Repite con la mitad que queda. Es la misma idea que buscar un nombre en una guía telefónica abriéndola por la mitad, y encuentra la primera compilación mala en unos pocos pasos, incluso entre muchas compilaciones.
No hace falta ser desarrollador para hacerlo. Necesitas acceso a las compilaciones y paciencia para ejecutar los mismos pasos cada vez.
Paso cuatro: anota qué cambió entre ambas
Una vez que tienes la última compilación buena y la primera mala, mira lo que hay entre ellas. No se espera que encuentres la causa, pero unas líneas de contexto ayudan.
- Las notas de versión de la primera compilación mala.
- Un ajuste, una configuración o una dependencia que cambió.
- Una función que se añadió o se rehízo en la misma área.
Una frase como «el flujo del código promocional se rehízo en esta versión» es una pista sólida, y el desarrollador te la agradecerá.
Paso cinco: escribe el reporte
Un reporte de regresión es un reporte de error normal con dos campos extra. Este es un formato que puedes copiar:
``` Título: [Área] Síntoma (regresión)
Última buena conocida Compilación 2.13.2, los pasos de abajo funcionan como se espera.
Primera mala conocida Compilación 2.14.0, los pasos de abajo fallan.
Pasos para reproducir
- ...
- ...
- El paso en el que falla
Esperado Lo que pasaba en la última compilación buena.
Real Lo que pasa ahora.
Entorno Plataforma, tipo de cuenta, ajustes que importan.
Pruebas Fragmento del log, captura de pantalla, id de solicitud.
Qué cambió entre ambas Las notas de versión mencionan un flujo promocional rehecho.
Relacionados El ticket anterior que corrigió esto, si lo hubo. ```
El campo Relacionados es fácil de olvidar y vale la pena el esfuerzo. Una regresión a menudo reabre un problema antiguo, y el ticket que lo corrigió la primera vez guarda el historial de cómo se hizo.
Hábitos que ayudan
- Pon «regresión» en el título, para que el triaje pueda enviarlo al equipo que tocó esa área.
- Vincula el ticket antiguo, si el mismo síntoma ya se corrigió antes.
- Mantén idénticos los pasos entre compilaciones, para que la comparación sea justa.
- Indica la versión en la que lo notaste por primera vez, aunque no puedas acotarlo más. Una respuesta parcial sigue siendo una respuesta.
Dónde encaja BugIt
BugIt es un agente de control de calidad que funciona en el asistente que ya usas. Describes el problema en una frase rápida, sin pulir y BugIt redacta el reporte con el formato de tu equipo. Antes de que veas el borrador, busca en tu tracker, solo en modo lectura, tickets parecidos al tuyo y le asigna una puntuación a cada uno, de modo que un ticket anterior sobre el mismo síntoma puede aparecer como ticket relacionado. Tú sigues aportando lo que solo tú sabes, como la última compilación buena, y BugIt te pide lo que falta, incluidas la compilación y la frecuencia con que ocurre. BugIt oculta los datos personales comunes en la medida de lo posible, así que lee el borrador. Tú revisas cada borrador antes de que se registre, y no se escribe nada en tu tracker hasta que escribas FILE IT.
Más información en bugit.dev y taskivator.com/bugit.
En resumen
Una regresión es un error que viene con ventaja. Confirma que el comportamiento anterior era real, encuentra la última compilación buena, luego divide el intervalo a la mitad para encontrar la primera mala y anota qué cambió entre ambas. Pon las dos compilaciones en el reporte, vincula un ticket anterior y el desarrollador sabrá por dónde empezar a buscar.