Dejad de enviar tickets de «no funciona» (piedad para los equipos técnicos).

¡Hola! A todos nos ha pasado: encuentras algo que no funciona en tu app, envías un mensaje rápido al equipo técnico diciendo «esto no funciona» y… nada. O te responden tres horas después preguntándote qué se supone que deben mirar. Es frustrante, pero en realidad, suele ser porque el informe de error es ilegible.

De hecho, el problema de los mensajes vagos es que obligan al desarrollador a salir de su «burbuja». Están trabajando en algo complejo, reciben la alerta y de repente tienen que jugar a los detectives. Eso rompe su concentración y crea fricciones innecesarias.

Un título que signifique algo

Lo primero es el título. Evita cosas como «Error urgente» o «Problema de visualización«. No significan nada cuando el equipo tiene una lista de 50 tickets que gestionar. Hay que ser fáctico.

Por ejemplo: «El botón de validación se queda en gris en el formulario de contacto». Ahí, al menos, sabemos inmediatamente dónde mirar. Es directo, es claro y ahorra muchísimo tiempo.

La estructura ideal (El «Template» perfecto)

No hace falta rellenar un formulario administrativo. Aquí tienes una estructura sencilla que puedes copiar y pegar en tus tickets para ser lo más preciso posible:

• Título: [Página/Módulo] – Descripción corta del problema.
• Contexto: ¿Qué dispositivo? ¿Qué navegador? (Ej: Chrome en Windows 11).
• Pasos para reproducir:
  1. Voy a la página…
  2. Hago clic en el botón…
  3. Introduzco el valor…
• Resultado actual: Lo que pasa realmente (el error).
• Resultado esperado: Lo que debería pasar normalmente.
• Archivo adjunto: Una captura de pantalla o un pequeño vídeo.

Las capturas de pantalla son la vida

En serio, una imagen vale más que mil palabras. Si puedes hacer una captura, o mejor aún, un pequeño vídeo de tu pantalla (la herramienta de recortes de Windows sirve), hazlo. Muestra el entorno, los mensajes de error extraños e incluso la URL exacta en el momento del error.

El truco del experto: Haz clic derecho en la página que falla, ve a «Inspeccionar» y luego a la pestaña «Consola». Si ves líneas en rojo, hazles una foto. Es el diagnóstico directo para el dev.

Herramientas que ayudan

Captura de Vídeo e Imagen

• Loom: Para grabar tu pantalla y explicar el error de viva voz.
• CleanShot X (Mac) o ShareX (Windows): Para capturas anotadas limpiamente.

Informes de errores automatizados

• Jam: La herramienta definitiva que graba el vídeo Y los registros técnicos (consola) simultáneamente.
• Marker.io: Para enviar comentarios visuales directamente a tus herramientas de gestión.

Gestión de proyectos

• Linear: La herramienta favorita de los devs por su rapidez.
• Jira: El estándar para grandes estructuras.
• Notion: Ideal para centralizar errores de forma sencilla.

En resumen: hacer un buen ticket de bug no es burocracia, es simplemente empatía. Ayudas a tu colega a ayudarte. Cuanto más fáctico seas, menos emoción y estrés habrá, y mejor funcionará el sitio. Es un pequeño esfuerzo que ahorra horas a todo el mundo.