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.
septiembre 2026

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.

Categorías:
1Ingeniería de frontend	/es/categories/frontend/	software.engineer.company	70
1Seguridad	/es/categories/security/	software.engineer.company	70
1Pruebas y control de calidad	/es/categories/testing/	software.engineer.company	70
1Diseño UX/UI	/es/categories/ux-ui/	software.engineer.company	70
1Producto y requisitos	/es/categories/product/	software.engineer.company	70
1Documentación	/es/categories/documentation/	software.engineer.company	70

Servicios:
1Diseño UI/UX y sistemas de diseño	/es/services/ui-ux-design/	software.engineer.company	70
1Estrategia de producto y requisitos	/es/services/product-strategy/	software.engineer.company	70
1Documentación técnica	/es/services/technical-documentation/	software.engineer.company	70

hEsta página en la web	URL:https://software.engineer.company/es/portfolio/rewrote-error-messages-to-stop-blaming-users/	software.engineer.company	70
