sayhush

NOTAS DE SAYHUSH

Cómo dictar un informe de error con pasos reproducibles

Por · Revisado el

Un informe de error útil incluye entorno, pasos mínimos conocidos, comportamiento esperado y real. Describe lo observado sin adivinar la causa. Organiza la transcripción en secciones identificadas antes de enviarla.

Registra primero el entorno

Anota versión del producto, sistema operativo y navegador o editor relevante. Si desconoces una versión, búscala en lugar de dictar un número plausible. Usa una reproducción de prueba cuando puedas. Un ejemplo mínimo con texto ficticio puede ser más fácil de compartir que un informe con datos reales de clientes.

Di los pasos en el orden real

Un ejemplo: «En la versión de prueba abro Ajustes, elijo el tema oscuro, cierro Ajustes y lo vuelvo a abrir. La vista previa sigue clara hasta que cambio el tamaño de la ventana». Di los pasos reales, incluido si reiniciaste la app. Evita «siempre ocurre» salvo que hayas repetido pruebas y puedas describirlas fielmente.

Separa resultado esperado y real

Organiza manualmente el ejemplo: «Pasos: abrir Ajustes, elegir tema oscuro, cerrar y reabrir». «Esperado: la vista previa refleja el tema elegido». «Real: sigue clara hasta redimensionar la ventana». Es un ejemplo didáctico ficticio, no un fallo reportado de Sayhush. Añade a tu informe la versión y frecuencia de reproducción reales.

Deja la causa supuesta como hipótesis

«La vista previa no se actualizó» es una observación. «La caché de renderizado está rota» es una teoría salvo que la hayas investigado. Separa la teoría y las pruebas que la sostienen. Sayhush no inspecciona registros ni identifica funciones fallidas, y tampoco reproduce problemas desde tus palabras: aporta el texto que dictas.

Adjunta pruebas de forma deliberada

Añade tú una captura o fragmento de registro sin información privada si ayuda a reproducir. Escribe rutas, identificadores y códigos exactos cuando el reconocimiento los altere. En registros largos, pega el fragmento pertinente en vez de leerlo. Comprueba que el adjunto corresponda a la versión y estado descritos.

Repite el informe escrito

Sigue tus propios pasos escritos en un entorno de prueba. Añade cualquier paso omitido que impida reproducir. Otra persona debería entender el resultado esperado sin adivinar. Revisa nombres, números y negaciones antes de enviar. Esta repetición final vale más que dar un tono pulido a un informe incierto.

Tu lista rápida

  1. Registra entorno y versión reales.
  2. Enumera los pasos mínimos conocidos.
  3. Separa comportamiento esperado y real.
  4. Marca las causas supuestas como hipótesis.
  5. Elimina secretos de las pruebas antes de compartir.