BugIt3 min de lectura

Cómo escribir un título de error que se tenga en cuenta en el triaje

El título de un error es la única línea que lee la mayoría. Aprende qué poner en él, qué dejar fuera y cómo probarlo en la lista de un tracker antes de registrarlo.

Un título de error vago junto a un título claro que indica el área, el síntoma y la condición.

Abre un tracker con mucho movimiento y mira la vista de lista. Ves una fila por ticket: un ID, un estado y un título. Nada más. En esa fila es donde un error se acepta, se ignora, se fusiona con otro ticket o se devuelve con una pregunta, y la decisión a menudo se toma antes de que nadie abra la descripción.

Así que el título trabaja más que cualquier otra línea que escribas. Aquí verás cómo hacer que esté a la altura.

Qué tiene que hacer un título

En la vista de lista, un título tiene tres tareas.

  • Decir dónde. El área, la pantalla o el comando, para que lo vea la persona adecuada.
  • Decir qué falla. El síntoma que viste, no tu teoría sobre la causa.
  • Ser fácil de encontrar. Quien se tope con el mismo error el mes que viene buscará unas pocas palabras. Tu título debería contener las palabras que usaría esa persona.

Un formato que funciona

Prueba este orden: dónde, luego qué pasó y luego la condición que importa.

`` Pago: el código promocional se aplica dos veces al usar el botón Atrás Exportación: el CSV sale vacío cuando el intervalo de fechas pasa de un año a otro Inicio de sesión: aparece el error 500 tras restablecer la contraseña en la web móvil ``

Cada título indica un área, describe el síntoma y añade la única condición que distingue este error de otros parecidos. Un desarrollador que recorra la lista puede saber cuál de ellos le toca.

Títulos que te salen caros

| Título | Qué falla | |---|---| | «Error en el pago» | No indica ningún síntoma. Podría ser cualquier ticket del pago. | | «Arreglar la exportación» | Una tarea, no un reporte. Da por supuesta una causa y oculta las pruebas. | | «El botón no funciona» | ¿Qué botón, y qué significa «no funciona»? | | «¡¡¡URGENTE!!! App rota» | La urgencia va en el campo de prioridad, y «rota» no es un síntoma. | | «Cierre inesperado intermitente» | ¿Dónde? ¿En qué condiciones? Acabará fusionado con la coincidencia más cercana. |

Describe el síntoma, no la suposición

«La caché no se borra después de guardar» es una suposición. «Se sigue mostrando el precio antiguo después de guardar uno nuevo» es lo que viste. Si tu suposición es errónea, ponerla en el título manda al desarrollador al código equivocado y hace que el ticket sea más difícil de encontrar para quien vea el mismo síntoma con otra causa. Pon tu teoría en la descripción, marcada como teoría.

Incluye el texto del error, si lo hay

Si el producto mostró un mensaje, una cita breve de él es el mejor término de búsqueda que le puedes dar a la siguiente persona. Mantenla breve y deja fuera los ID, correos electrónicos y cualquier dato personal. «El pago falla con 'tarjeta rechazada' para una tarjeta válida» encuentra a sus gemelos.

Prueba el título antes de registrarlo

Haz dos comprobaciones rápidas.

  1. Léelo de forma aislada. Tapa la descripción. ¿Podría un desconocido saber qué falla y dónde?
  2. Busca con él. Pega tu título en la búsqueda del tracker. Si aparece un ticket anterior, léelo antes de registrar el tuyo. Si tu título no encuentra un ticket que sabes que existe, el título de ese ticket es flojo, y puede que el tuyo necesite las palabras que le faltan. Nuestro artículo sobre cómo detectar errores duplicados antes de registrarlos trata la búsqueda en sí.

Mantén los títulos lo bastante cortos como para leerlos en una lista y lleva los detalles a la descripción. Un título que ocupa varias líneas suele estar cargando con una descripción.

Dónde encaja BugIt

Es fácil acertar con el título cuando estás tranquilo y equivocarse cuando tienes prisa. Cuando le describes un problema a BugIt en una nota suelta, este redacta un reporte con un título con este formato y busca en tu tracker tickets parecidos antes de que veas el borrador. La búsqueda solo lee. Tú revisas el borrador, cambias el título si quieres, y BugIt oculta los datos personales comunes en la medida de lo posible. No se escribe nada en tu tracker hasta que escribas FILE IT.

Mira cómo funciona en taskivator.com/bugit y bugit.dev.

En resumen

Escribe el título pensando en la vista de lista: dónde, qué pasó y la única condición que importa. Describe lo que viste, cita el error si lo hay y busca con tu propio título antes de registrarlo.

Ya disponibleAgente de control de calidad para tu asistente de IA

BugIt

Español