Errores que dejan de culpar al usuario
Reescribí los mensajes de error de la aplicación conforme a un criterio de tono documentado después de que un inicio de sesión rechazado culpara al usuario de escribir mal la contraseña cuando el proveedor exigía una específica para aplicaciones, y lo cubrí con una prueba que identifica al proveedor.
Trabajo realizado: septiembre 2026
mensajes de error que identifican la causa sin culpar al usuario
Situación. Un inicio de sesión contra un gran proveedor de correo falló y la aplicación dijo al usuario que su contraseña era incorrecta. No era incorrecta. Ese proveedor exige una contraseña específica de aplicación para clientes de terceros y rechaza la contraseña de la cuenta por mucho cuidado que se ponga al escribirla. El mensaje enviaba al usuario a reescribir algo que nunca podría funcionar, y la instrucción real — ir a generar otro tipo de contraseña — no aparecía en ninguna parte.
Tarea. Había que reescribir los mensajes de error conforme a un estándar escrito en lugar de parchearlos uno a uno, ya que este era el caso visible de un hábito que recorría todos ellos.
Acción. El estándar tiene tres requisitos: decir qué ocurrió, no dar nunca a entender que el usuario hizo algo mal cuando la causa está en otra parte y ofrecer la siguiente acción cuando exista. Al aplicarlo al conjunto de mensajes de error, la mayoría incumplía al menos uno: varios se limitaban a transmitir la cadena de error de la biblioteca subyacente, que describe una condición a un programador en lugar de una situación a una persona. El caso del proveedor se reescribió para nombrarlo, indicar que exige una contraseña específica de aplicación para otros clientes y explicar dónde crearla. La prueba es lo que evita la regresión, y es deliberadamente específica: provoca un fallo de inicio de sesión contra ese proveedor y verifica que el mensaje contenga el nombre del proveedor y la expresión que describe el tipo de credencial requerido. Una prueba que solo verificara que apareció algún error pasaría con el mensaje original incorrecto, de modo que la aserción se aplica al contenido, que es la única parte que estuvo mal.
Resultado. El conjunto de mensajes de error sigue un estándar explícito y el caso que lo motivó está cubierto por una prueba que falla con el texto antiguo. Lo que sigue sin resolverse es la escala: el estándar se hace cumplir mediante revisión y una prueba sobre un mensaje, y los demás proveedores con requisitos particulares propios no tienen una prueba equivalente, de modo que la clase está documentada, no cerrada.

Foto: SamuelFJohanns / Pixabay 
Foto: beasternchen / Pixabay
Aplique esta experiencia a su proyecto
Utilice «Errores que dejan de culpar al usuario» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. Convertir las necesidades del negocio en algo que se pueda desarrollar y decir con claridad qué no merece la pena construir.
Mire más allá del resultado
Lea la situación, las decisiones y el resultado de este ejemplo. Podemos hablar de qué partes se adaptan a sus restricciones y cuáles necesitan otro enfoque. Errores que dejan de culpar al usuario — mensajes de error que identifican la causa sin culpar al usuario
Eche un vistazo al Portafolio completo.
Una parte de una trayectoria más amplia — y toda ella está en este sitio.
Cada entrada sigue la misma estructura: la situación, la tarea, lo que hicimos y lo que cambió.

