Des messages d’erreur bien conçus aident les utilisateurs à comprendre ce qui n’a pas fonctionné et comment y remédier — réduisant ainsi la frustration et les demandes de support. Ce guide établit des normes pour écrire des messages d’erreur clairs, cohérents et empathiques à travers l’interface utilisateur.
Principes fondamentaux
| Principe | Ce que cela signifie |
|---|---|
| Clarté | Utilisez un langage simple et quotidien. Évitez le jargon et les descriptions vagues. |
| Capacité d’action | Dites à l’utilisateur exactement quoi faire ensuite. Si aucune action n’est nécessaire, dites-le. |
| Empathie | Ne blâmez jamais l’utilisateur. Utilisez des formulations neutres et de soutien. |
| Régularité | Utilisez le même ton, la même structure et la même terminologie pour tous les messages (par exemple, ne mélangez pas « erreur serveur » et « erreur système » pour le même problème). |
| Breffait | Faites court — assez de contexte pour être utile, plus maintenant. |
| Accessibilité | Suivez les directives WCAG afin que les messages soient compréhensibles pour les utilisateurs de tous niveaux. |
Anatomie d’un message d’erreur
Chaque message d’erreur devrait répondre jusqu’à trois questions :
- Que s’est-il passé ? Énoncez le problème clairement.
- Pourquoi cela s’est-il produit ? (optionnel) Ajoutez une brève raison si cela aide l’utilisateur à comprendre.
- Que doit faire l’utilisateur ensuite ? Donnez une action ou un point précis pour aider davantage.
Structure :
| Composant | Exemple |
|---|---|
| En-tête | « Impossible de traiter la demande » |
| Description | « Nous avons rencontré un problème lors du traitement de votre demande. Veuillez réessayer. » |
| Action/Aide | « Si le problème persiste, contactez le support à support@document360.com. » |
Directives d’écriture
| Directives | ✅ Do | ❌ Ne le fais pas |
|---|---|---|
| Utiliser un langage simple | « La taille du fichier dépasse la limite autorisée. » | « Téléchargement de fichier échoué en raison de contraintes de taille. » |
| Sois précis | « Adresse e-mail invalide. Veuillez entrer un format valide (par exemple, name@domain.com). » | « Erreur d’entrée. » |
| Proposez une solution | « Le nom d’utilisateur est déjà pris. Essaie un autre nom d’utilisateur. » | « Ce nom d’utilisateur n’est pas disponible. » |
| Évitez le jargon technique | « Nous n’avons pas pu nous connecter au serveur. Vérifie ta connexion internet et réessaie. » | « Erreur serveur 503 détectée. » |
| Utilisez un langage poli et positif | « Quelque chose a mal tourné. Veuillez réessayer dans quelques minutes. » | « Erreur ! Essaie encore. » |
| Alignez-vous avec le contexte | « Nous n’avons pas pu sauver ça. Veuillez réessayer. » | « Erreur de sauvegarde ! Action bloquée ! » |
| Utilisez la voix active | « Nous n’avons pas trouvé l’article demandé. » | « L’article demandé n’a pas été trouvé. » |
| Évitez les mots négatifs | « Nous n’avons pas pu satisfaire votre demande. » | « Échec de traiter ta demande. » |
Codes d’erreur : Incluez-les uniquement pour les erreurs complexes ou techniques où elles aident au dépannage.
Exemple : « La demande n’a pas pu être traitée (Code d’erreur : 403). Contactez le support pour obtenir de l’aide. »
Scénarios d’erreur courants
| Scénario | Message d’erreur |
|---|---|
| Entrée invalide | « Mot de passe invalide. Le mot de passe doit comporter au moins 8 caractères et inclure un chiffre. » |
| Champ requis manquant | « Une adresse e-mail est requise. Veuillez entrer votre e-mail pour continuer. » |
| Délai d’expiration serveur | « Nous avons du mal à nous connecter au serveur. Veuillez réessayer plus tard. » |
| Erreur de téléchargement de fichier | « Téléchargement de fichier échoué. Assurez-vous que le fichier est inférieur à 5 Mo et dans un format pris en charge. » |
| Accès refusé | « Tu n’as pas la permission de consulter cette page. Contactez votre administrateur. » |
| Échec de paiement | « Le paiement n’a pas pu être traité. Vérifie les détails de ta carte ou essaie une autre méthode. » |
| Entrée en double | « Ce nom de catégorie existe déjà. Veuillez choisir un autre nom. » |
| Session expirée | « Votre séance est terminée. Veuillez vous reconnecter pour continuer. » |
Liste de contrôle avant publication
- Le message est-il clair et concis ?
- Est-ce que cela explique ce qui a mal tourné ?
- Est-ce que cela offre une étape suivante concrète ?
- Est-ce dépourvu de jargon technique ?
- Le ton est-il poli et professionnel ?
- Est-ce cohérent avec d’autres messages d’erreur dans le produit ?
Entretien
Examinez périodiquement tous les messages d’erreur au fur et à mesure de l’évolution des fonctionnalités du produit, et mettez-les à jour rapidement pour éviter des consignes obsolètes ou confuses.