# Les textes des écrans

Écrire pour le métier : boutons, états, erreurs, écrans vides.


Le lecteur ne connaît que son métier. Un texte d'écran se lit en une seconde, sans avoir à comprendre le logiciel.

:::note[En bref]
- **TEXTE-01** · [Écrivez des rôles, jamais des noms](#texte-01--écrivez-des-rôles-jamais-des-noms)
- **TEXTE-02** · [Utilisez le même mot partout](#texte-02--utilisez-le-même-mot-partout)
- **TEXTE-03** · [Nommez un titre de bloc, ne le phrasez pas](#texte-03--nommez-un-titre-de-bloc-ne-le-phrasez-pas)
- **TEXTE-04** · [Faites dire au bouton ce qu'il fait](#texte-04--faites-dire-au-bouton-ce-quil-fait)
- **TEXTE-05** · [Dites ce qui bloque, puis ce qu'il faut faire](#texte-05--dites-ce-qui-bloque-puis-ce-quil-faut-faire)
- **TEXTE-06** · [Dites ce qui manque dans un écran vide](#texte-06--dites-ce-qui-manque-dans-un-écran-vide)
- **TEXTE-07** · [Écrivez une phrase, une idée, au présent, avec « vous »](#texte-07--écrivez-une-phrase-une-idée-au-présent-avec--vous-)
- **TEXTE-08** · [N'expliquez pas l'écran dans l'écran](#texte-08--nexpliquez-pas-lécran-dans-lécran)
- **TEXTE-09** · [Citez le nom exact](#texte-09--citez-le-nom-exact)
:::

## Les mots de l'écran

### TEXTE-01 · Écrivez des rôles, jamais des noms

:::tip[Règle]
Un texte d'écran ne contient ni nom de personne, ni nom de client, ni mot propre à une société. Le lecteur ne connaît que son métier.
:::

| À éviter | À faire |
| --- | --- |
| « Envoyer à Jean Dupont » | « Envoyer au chargé d'affaires » |

<span class="puce relecture">Relecture</span> Le relecteur des écrans le vérifie.

### TEXTE-02 · Utilisez le même mot partout

:::tip[Règle]
Un même mot désigne toujours la même chose, et le vocabulaire vient d'une table ou d'un module unique, jamais d'une liste écrite dans l'écran.
:::

<span class="puce relecture">Relecture</span> La table des états et le module du vocabulaire en sont la mise en œuvre.

### TEXTE-03 · Nommez un titre de bloc, ne le phrasez pas

:::tip[Règle]
Un titre de bloc est un nom, pas une phrase.
:::

| À éviter | À faire |
| --- | --- |
| « Ce que les factures en disent » | « Factures » |
| « Ce que vous pouvez faire ici » | « Actions » |

<span class="puce outil">Outil</span> Une règle ESLint contrôle le titre de bloc.

## Les gestes

### TEXTE-04 · Faites dire au bouton ce qu'il fait

:::tip[Règle]
Un bouton porte un verbe et son objet. Une confirmation reprend le verbe du bouton qui l'a ouverte.
:::

| À éviter | À faire |
| --- | --- |
| « OK », « Valider », « Envoyer » | « Enregistrer la commande », « Retirer l'accès » |

<span class="puce relecture">Relecture</span> Boutons et confirmations se relisent.

### TEXTE-05 · Dites ce qui bloque, puis ce qu'il faut faire

:::tip[Règle]
Une erreur dit ce qui bloque, puis ce qu'il faut faire, avec les mots de l'écran, sans code ni nom de champ technique.
:::

| À éviter | À faire |
| --- | --- |
| « Erreur 23505 » | « Cette référence existe déjà. Choisissez-en une autre. » |

<span class="puce relecture">Relecture</span> Les erreurs se relisent.

### TEXTE-06 · Dites ce qui manque dans un écran vide

:::tip[Règle]
Un écran vide dit ce qui manque, pas qu'il n'y a rien.
:::

| À éviter | À faire |
| --- | --- |
| « Aucun résultat » | « Aucune facture à valider. » |

<span class="puce relecture">Relecture</span> Les écrans vides se relisent.

## Le ton

### TEXTE-07 · Écrivez une phrase, une idée, au présent, avec « vous »

:::tip[Règle]
On évite « on », les mots creux, l'antithèse et la phrase qui redit la précédente.
:::

| À éviter | À faire |
| --- | --- |
| « On vous invite à bien vouloir renseigner le champ ci-dessous. » | « Renseignez le délai. » |

<span class="puce relecture">Relecture</span> La langue et le ton se relisent.

### TEXTE-08 · N'expliquez pas l'écran dans l'écran

:::tip[Règle]
Le fonctionnement va dans l'aide. Un bouton dit l'action. Pas de tiret cadratin, pas de nom d'outil ni d'assistant dans un texte de l'application.
:::

<span class="puce relecture">Relecture</span> L'aide vit dans son dossier, décrit par son fichier de présentation.

### TEXTE-09 · Citez le nom exact

:::tip[Règle]
Une phrase de documentation qui nomme une fonction, une table, une colonne ou un fichier cite son nom exact, vérifié au moment où elle s'écrit.
:::

<span class="puce relecture">Relecture</span> Un nom inexact casse la recherche et trompe l'agent qui suit la phrase.

## Référence rapide

| Règle | À retenir | Tenue par |
| --- | --- | --- |
| **TEXTE-01** | Écrivez des rôles, jamais des noms | Relecture |
| **TEXTE-02** | Utilisez le même mot partout | Relecture |
| **TEXTE-03** | Nommez un titre de bloc, ne le phrasez pas | Outil |
| **TEXTE-04** | Faites dire au bouton ce qu'il fait | Relecture |
| **TEXTE-05** | Dites ce qui bloque, puis ce qu'il faut faire | Relecture |
| **TEXTE-06** | Dites ce qui manque dans un écran vide | Relecture |
| **TEXTE-07** | Écrivez une phrase, une idée, au présent, avec « vous » | Relecture |
| **TEXTE-08** | N'expliquez pas l'écran dans l'écran | Relecture |
| **TEXTE-09** | Citez le nom exact | Relecture |
