Erreurs réécrites sans blâmer les utilisateurs
Réécrit les messages d'erreur de l'application selon une charte de
ton après qu'un refus de connexion reprochait une faute de frappe à
l'utilisateur alors que le fournisseur exigeait un mot de passe
d'application, avec un test nommant ce fournisseur.
septembre 2026

Situation. Une connexion à un grand fournisseur de courrier a
échoué, et l'application a indiqué à l'utilisateur que son mot de
passe était incorrect. Il ne l'était pas. Ce fournisseur exige un
mot de passe propre à l'application pour les clients tiers et
rejette celui du compte, aussi soigneusement soit‑il saisi. Le
message poussait l'utilisateur à retaper quelque chose qui ne
pourrait jamais fonctionner, tandis que la véritable instruction —
aller générer un autre type de mot de passe — n'apparaissait nulle
part.

Tâche. Les messages d'erreur devaient être réécrits selon une norme
écrite plutôt que corrigés un par un, car celui‑ci était le cas
visible d'une habitude qui les traversait tous.

Action. La norme comporte trois exigences : dire ce qui s'est passé,
ne jamais laisser entendre que l'utilisateur a mal agi lorsque la
cause est ailleurs, et donner l'action suivante lorsqu'elle existe.
Sur l'ensemble des erreurs, la plupart des messages en enfreignaient
au moins une — plusieurs transmettaient directement la chaîne
d'erreur de la bibliothèque sous‑jacente, qui décrit une condition à
un programmeur plutôt qu'une situation à une personne. Le cas du
fournisseur a été réécrit pour le nommer, indiquer qu'il exige un
mot de passe propre à l'application pour les autres clients et dire
où le créer. Le test empêche la régression et est délibérément
précis : il provoque un échec de connexion à ce fournisseur et
vérifie que le message contient son nom ainsi que l'expression
décrivant le type d'identifiant requis. Un test vérifiant seulement
qu'une erreur est apparue réussirait avec l'ancien message
incorrect ; l'assertion porte donc sur le contenu, seule partie qui
ait jamais été défectueuse.

Résultat. Les erreurs suivent une norme explicite et le cas qui l'a
motivée est couvert par un test qui échoue sur l'ancien texte. Ce
qui reste non résolu est l'échelle : la norme est imposée par
relecture et par un test sur un message, et les autres fournisseurs
ayant leurs propres exigences n'ont pas de test équivalent ; la
catégorie est donc documentée plutôt que fermée.

Catégories:
1Ingénierie frontend	/fr/categories/frontend/	advisory.engineer.company	70
1Sécurité	/fr/categories/security/	advisory.engineer.company	70
1Tests et assurance qualité	/fr/categories/testing/	advisory.engineer.company	70
1Conception UX/UI	/fr/categories/ux-ui/	advisory.engineer.company	70
1Produit et besoins métier	/fr/categories/product/	advisory.engineer.company	70
1Documentation	/fr/categories/documentation/	advisory.engineer.company	70

Prestations:
1Conception UI/UX et systèmes de design	/fr/services/ui-ux-design/	advisory.engineer.company	70
1Stratégie produit et définition des besoins	/fr/services/product-strategy/	advisory.engineer.company	70
1Documentation technique	/fr/services/technical-documentation/	advisory.engineer.company	70

hCette page sur le Web	URL:https://advisory.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/	advisory.engineer.company	70
