{"canonical_url":"https://engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/","content_markdown":"# Erreurs réécrites sans blâmer les utilisateurs\n\nRéé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.\n\nseptembre 2026\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n---\n\n- Rôle: Conceptrice de contenu\n- Catégories: [Ingénierie frontend](https://software.engineer.company/fr/categories/frontend/), [Sécurité](https://software.engineer.company/fr/categories/security/), [Tests et assurance qualité](https://software.engineer.company/fr/categories/testing/), [Conception UX/UI](https://software.engineer.company/fr/categories/ux-ui/), [Produit et besoins métier](https://software.engineer.company/fr/categories/product/), [Documentation](https://software.engineer.company/fr/categories/documentation/)\n- Prestations: [Conception UI/UX et systèmes de design](https://software.engineer.company/fr/services/ui-ux-design/), [Stratégie produit et définition des besoins](https://software.engineer.company/fr/services/product-strategy/), [Documentation technique](https://software.engineer.company/fr/services/technical-documentation/)\n\n\u003chttps://engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"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.","formats":{"gemtext":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/index.gmi","gopher":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/gophermap","html":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/","json":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/index.json","markdown":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/index.md","pdf":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/index.pdf"},"kind":"page","language":"fr","title":"Erreurs réécrites sans blâmer les utilisateurs","url":"https://software.engineer.company/fr/portfolio/rewrote-error-messages-to-stop-blaming-users/","version":1}