BugIt3 min de lectura

¿Es un error o el comportamiento esperado? Cómo comprobarlo antes de registrarlo

Antes de registrarlo, comprueba si el comportamiento es un error, una función que falta o algo intencionado. Un método breve que usa la especificación, las notas de versión, la configuración y el tracker.

Un camino de decisión que parte de revisar la especificación y llega a tres resultados: error, comportamiento esperado o un vacío en la especificación.

Algunos de los tickets más caros no son errores. El producto hizo lo que debía hacer, quien lo reportó esperaba otra cosa y un desarrollador se pasa una mañana demostrándolo. Lo contrario cuesta lo mismo: un error real se cierra como «funciona según el diseño» porque quien lo reportó no pudo mostrar lo que dice el diseño.

Unos minutos de comprobación antes de registrar el ticket resuelven la mayoría de estos casos. Aquí tienes un método.

Empieza por la fuente de verdad

Un comportamiento es un error cuando contradice algo que el equipo acordó. Busca ese algo, en este orden.

  • La especificación, la historia de usuario o los criterios de aceptación. Si dice lo que debería pasar y el producto hace otra cosa, tienes un error. Cita la línea en el reporte.
  • Las notas de versión y los registros de cambios. Puede que se haya anunciado un cambio. Si es así, estás ante una decisión, no ante un defecto, aunque quizá no estés de acuerdo con ella.
  • La documentación y los textos de ayuda. Las propias palabras del producto son una prueba. Una página que dice una cosa mientras la pantalla hace otra merece un reporte en cualquier caso.
  • El tracker. Busca el comportamiento en los tickets abiertos y cerrados. Un ticket cerrado marcado como «por diseño» te ahorra registrarlo, y uno abierto te indica que añadas ahí tus pruebas.

Descarta tu propia configuración

Buena parte de los «errores» vienen del entorno. Comprueba estos puntos antes de escribir nada.

  • Permisos y roles. ¿Cambia el comportamiento si usas una cuenta con otro rol?
  • Ajustes e indicadores de función. ¿Hay algún ajuste o indicador de función activado que no esperabas?
  • Datos. ¿Una cuenta nueva, un archivo más pequeño u otra entrada se comportan de otra forma?
  • Versión. ¿Estás en la compilación que crees, y es la que describe la especificación?
  • Caché y estado obsoleto. ¿Una sesión limpia muestra el mismo resultado?

Si al cambiar uno de estos puntos el comportamiento desaparece, has aprendido algo real. Puede que siga siendo un error, como un valor predeterminado confuso o un mensaje que falta, pero es un reporte distinto.

Tres resultados honestos

| Lo que encontraste | Qué registrar | |---|---| | El producto contradice la especificación o su propia documentación | Un error. Cita ambas. | | El comportamiento es intencionado pero sorprendente o poco claro | Un problema de usabilidad o de documentación. Di qué te confundió. | | El comportamiento es intencionado y quieres algo distinto | Una solicitud de función, marcada como tal. |

Registrarlo en la categoría correcta no es pedantería. Envía el ticket a la persona que puede actuar y mantiene honestos tus recuentos de defectos.

Cuando la especificación no dice nada

A veces nada indica lo que debería pasar. No adivines. Describe lo que hiciste, lo que pasó y lo que esperabas, di claramente que ninguna especificación lo cubre y pide a la persona responsable que decida. Así una discusión vaga se convierte en una pregunta clara.

Escribe el reporte para que resista un «funciona según el diseño»

Si registras un error, haz que sea difícil descartarlo. Di qué fuente consultaste, cita la línea que fija la expectativa y muestra los pasos y el resultado. Nuestra guía para reportar una regresión explica cómo añadir la última versión que se comportaba correctamente, lo que es una prueba sólida de que el comportamiento actual es un cambio y no una decisión de diseño.

Dónde encaja BugIt

BugIt no decide por ti si algo es un error, y no debería hacerlo. Toma tu nota suelta y la convierte en un reporte estructurado con los pasos, el resultado esperado y el real, lo que hace que la pregunta se vea con facilidad, y busca en tu tracker tickets parecidos antes de que veas el borrador para que puedas encontrar una decisión anterior. Tú revisas el borrador y eliges la categoría. BugIt oculta los datos personales comunes en la medida de lo posible, y no se escribe nada en tu tracker hasta que escribas FILE IT.

Más información en taskivator.com/bugit y bugit.dev.

En resumen

Revisa la especificación, las notas de versión, la documentación y el tracker, descarta tu propia configuración y registra el ticket en la categoría que respaldan las pruebas. Una comprobación breve al principio mantiene abiertos los errores reales y deja fuera lo que no son errores.

Ya disponibleAgente de control de calidad para tu asistente de IA

BugIt

Español