« Voltar
em carreira programação produtividade programador iniciante

O Guia do Programador Iniciante: escrevendo mensagens de erro.

No primeiro post do Guia do Programador Iniciante, falei sobre como pedir ajuda para seus colegas de trabalho.

Agora...quantas vezes você já a frase "Errar é humano"?
Mais do que gostaria, talvez.

Quem desenvolve programas? Humanos. E se humanos cometem erros, logo, programas também.
O bom é que podemos prever quando os programas irão falhar :)
E tem uma coisa que muitos não dão o devido valor, mas que é importantíssimo: as mensagens de erro.

Vamos então conversar um pouquinho sobre como você pode escrever essas mensagens de forma efetiva.

1- Evite mensagens genéricas

Suponhamos que você vá usar um cupom de desconto que seu amigo passou pra comprar um livro. Você entra no site, escolhe o livro, insere o cupom na hora da compra e recebe a mensagem:

Cupom inválido.

Inválido como? O que isso quer dizer? Eu digitei errado?

Essa mensagem é muito vaga.

Mesmo que a mensagem seja mais longa, é importante dizer ao usuário o que aconteceu, porque o cupom é inválido. Por exemplo:

Este cupom é inválido para livros da editora X. No entanto, você pode escolher livros de outras editoras e aproveitar o desconto.

Bem melhor, né? Agora você sabe o que fazer.

2- Sugira algo para o usuário

Ok, deu erro, e agora? O que o usuário deve fazer?

Você abre um app pra assistir um vídeo, e a mensagem que recebe é:

Impossível carregar vídeo.

Que legal hein parça, o que eu faço com isso?
Que tal:

Erro ao carregar vídeo. Você está conectado à internet?

Ou

Não foi possível carregar o vídeo. Seu aplicativo não está atualizado. Baixe aqui a ultima versão.

3- Cuidado com o tom

Pense em como o usuário irá se sentir naquela situação de erro. Se for algo extressante (como a maioria dos erros é), o ideal é que a menasagem não vá em tom engraçadinho nem sério demais.

Tente se colocar no lugar da pessoa. Como você se reagiria recebendo aquela mensagem de erro?

Por último, leia a mensagem de erro em voz alta e veja se isso é algo que você realmente diria pra alguém.


Quer ficar em dia com os meus posts e novidades? Se inscreva na minha newsletter, me segue no Twitter e na minha página!

comments powered by Disqus