Textes de l'interface
La voix des textes affichés par l'admin et le site, labels, messages d'erreur, confirmations, états vides et textes d'aide.
Les écrans du core et des modules officiels écrivent tous de la même façon. Cette page décrit cette voix, pour qu'une page ajoutée par un projet, un widget ou un module se lise comme le reste de l'admin.
Voix
La plateforme rapporte. Elle ne dit pas « on a fait », elle dit ce qui s'est passé. Pas de « vous » ni de « nous ».
✓ « Les modifications ont été enregistrées. » ✓ « La page a été supprimée. » ✗ « On a enregistré vos modifications. » ✗ « Nous avons bien reçu votre demande. »
Labels et boutons
Courts, un verbe à l'infinitif, sans point final, sans majuscule à chaque mot.
✓ « Enregistrer », « Supprimer », « Ajouter une page » ✗ « Cliquez ici pour enregistrer vos modifications » ✗ « Ajouter Un Élément »
Messages d'erreur
Nommer ce qui ne va pas. Dire quoi faire si c'est utile. Pas de code technique si l'utilisateur n'est pas développeur.
✓ « Ce champ est requis. » ✓ « Ce slug est déjà utilisé. En choisir un autre. » ✗ « Une erreur s'est produite. Veuillez réessayer. »
Messages de confirmation
Une phrase, au passé passif, sans « avec succès ».
✓ « Page enregistrée. » ✓ « Élément supprimé. » ✗ « Vos modifications ont été enregistrées avec succès ! »
États vides
Expliquer la situation, pas seulement la constater. Ajouter l'action à faire quand elle existe.
✓ « Aucune page pour l'instant. Créer la première. » ✗ « Aucun résultat trouvé. »
Textes d'aide
Une phrase. Répondre à « pourquoi » ou à « comment », pas aux deux.
✓ « Utilisé dans l'URL. Ne peut pas être modifié après publication. » ✗ « Le slug est un identifiant unique utilisé pour générer l'URL de la page. Il doit être en minuscules et ne peut pas contenir d'espaces ou de caractères spéciaux. »
Ce qu'on évite
Superlatifs et formules vides de premier plan, robuste, puissant, tout-en-un, intuitif, seamless
Le corporate notre plateforme vous permet de, dans une optique de, à cet effet
Chevilles inutiles Ainsi, En effet, Il convient de noter que, N'hésitez pas à, Veuillez noter que
Le tiret long dans une phrase Reformuler à la place : deux-points pour une explication, virgule pour une incise, point pour une phrase séparée. Le tiret reste admis comme marqueur de valeur absente dans une cellule de tableau.
La sur-promesse Si on ne peut pas le garantir, on ne l'écrit pas.