Recommandations pour de bonnes ressources sur la rédaction de bons messages d'erreur
Il est difficile d'écrire de bons messages d'erreur qui aident les utilisateurs à comprendre comment utiliser le système. Souvent, nous recevons des rapports de bogue indiquant "Le message d'erreur x prête à confusion", ce qui déclenche généralement un long débat au sein de l'équipe sur la façon de le reformuler.
Existe-t-il de bonnes ressources sur la façon d'écrire de bons messages d'erreur.
Je cherche
- livres
- Bons articles de blog
- papiers
- résultats de recherche
De nombreux livres de design le mentionnent mais n'y consacrent que quelques paragraphes.
Conception défensive pour le Web: comment améliorer les messages d'erreur, l'aide, les formulaires et autres points de crise (2004) par 37signals, bien que dépassé en 2011, vous montre divers exemples de mauvaise gestion des erreurs, y compris la copie et explique ce qui ne va pas et comment s'améliorer. Il appelle tout cela "conception de contingence" (le titre du livre est inspiré du concept de conduite défensive). Certains des modèles extraits sont toujours d'actualité. Amazon était notamment un leader dans ce domaine à l'époque.
La plus grande chose que j'en ai retirée lorsque je l'ai lu à l'époque était que votre site devait se comporter comme un vendeur dans un magasin: si je suis perdu ou si je ne trouve pas d'article, le vendeur me posera des questions pour m'aider trouver ce que je recherche alors que la plupart des sites Web diront simplement "Introuvable" et c'est tout. Voici un extrait du chapitre d'ouverture:
Ce livre vous montrera comment utiliser la conception d'urgence pour améliorer la convivialité de votre site. Vous apprendrez ce qui suit:
- En quoi consiste la conception d'urgence et pourquoi elle est importante
- 40 directives qui vous aideront à prévenir les erreurs et à sauver les clients en cas de problème
- Comment intégrer la récupération et la prévention des erreurs à votre processus de conception à long terme
- Comment évaluer la conception d'urgence de votre site afin que vous puissiez vous concentrer sur les domaines qui ont le plus besoin d'aide
Dans l'ensemble, le livre est utile pour concevoir la gestion des erreurs dans votre site ou application, mais il existe également de bons points spécifiques à la copie. À partir du chapitre deux, "Afficher le problème: afficher des messages d'erreur et des alertes évidents":
Un bon message d'erreur permet à un client de savoir instantanément:
- Qu'une erreur s'est produite
- Quelle est l'erreur
- Comment récupérer
Le chapitre contient un grand nombre d'exemples (de 2003) de sites (dont beaucoup n'existent plus). Chaque point de discussion comprend des exemples de sites qui font les choses dans le mauvais sens et pourquoi, et des exemples de sites qui font bien les choses et pourquoi.
Je cherchais également de bonnes ressources pour écrire des messages d'erreur efficaces. L'ensemble de ressources le plus utile que j'ai trouvé provenait de Microsoft:
J'ai également constaté que le manuel de style de Microsoft contenait des parties intéressantes qui pouvaient être appliquées aux messages d'erreur. Cela vaut la peine d'être lu si vous êtes intéressé à créer de la documentation, mais c'est une lecture longue (et probablement ennuyeuse) si vous êtes uniquement intéressé par la façon d'écrire de bons messages d'erreur.
Étant donné que je passe la majeure partie de mon temps à rédiger et à examiner des messages d'erreur, je pense personnellement qu'un bon message d'erreur devrait être composé de 3 parties:
- Le problème
- La cause
- La solution
Concentrez-vous d'abord sur l'écriture de ces trois parties, puis modifiez le texte pour le rendre plus petit et plus humain. J'ai écrit un article sur la façon d'écrire des messages d'erreur , mais si vous avez cloué ces trois parties dans votre message, vous avez déjà résolu 80% du problème.