Consejos para escribir mensajes de error efectivos

Cuando diseñamos software es parte del proceso validar que no tenga errores, sin embargo, también es parte del proceso alertar al usuario cuando es inevitable que suceda. En ese aspecto, muchos desarrolladores se preocupan por mostrar mensajes de error pero no que sean efectivos, o que le ayuden de verdad al usuario a entender lo que acaba de pasar. Por eso les presento algunas ideas y ejemplos de cómo poder escribir mensajes de error efectivos, y de esa forma no caer en problemas con mensajes de error confusos, que generen miedo, o que no aporten nada para los usuarios.

1. Sé claro, no ambiguo

Aún para un mismo error, es mejor especificar qué falló en el proceso, y no solo decir que el login no funcionó. Hay más ejemplos en la vida real en donde los mensajes no nos dicen nada sobre lo que pasó, solo que hubo un error inesperado o ¿catastrófico?

2. Mensaje corto y con significado

No necesitamos gastar muchos renglones para explicar un error. El significado está en la sencillez y en ser claro también, entonces, si un formato de correo está mal, solo decirlo así, que no cumple con el formato y listo. Sin embargo, tampoco hay que caer en el extremo.

3. No uses la jerga técnica

A ningún usuario le interesa saber a nivel técnico qué es lo que falló. Dar mensajes efectivos significa traducir los códigos de error, los mensajes de excepción de código, y cualquier referencia que no sea entendible por la gente que no entiende de código.

Muchas veces los desarrolladores olvidan que hay formas más efectivas para hacer depuración al código, y quizá para ellos es más fácil mostrarlos en un mensaje emergente.

4. No culpes al usuario

Los errores con parte del proceso, no por eso culpes al usuario de que hizo algo mal, mejor generaliza y no individualices.

5. Evita palabras negativas

El mostrarle al usuario palabras negativas le da la percepción de que algo hizo mal, o algo dejó de funcionar, y esto puede repercutir en que no quiera volver a intentarlo. Evita hacer de un error una catástrofe y relata los errores como algo que se puede arreglar o debe realizarse de nuevo.