Voix
Comment vanityURLs sonne dans la documentation, les pages generees, les badges et les surfaces produit.
Utilisez un langage direct et operationnel. Le lecteur doit sentir que vanityURLs traite les redirections avec soin, explique le comportement du systeme et respecte son temps.
Qualites de la voix
| Qualite | Signifie | Evite |
|---|---|---|
| Directe | Dire ce que le systeme fait | Promesses vagues ou benefices abstraits |
| Precise | Utiliser domaines, etats, chemins et temps exacts | Langage approximatif quand les details comptent |
| Calme | Expliquer les problemes sans drame | Formulations alarmistes pour des etats courants |
| Operationnelle | Aider a agir ou verifier | Texte poli mais peu informatif |
| Honnete | Decrire le comportement implemente | Impliquer des fonctions ou garanties absentes |
Verbes preferes
Utilisez des verbes concrets comme create, redirect, expire, block, audit, deploy, verify, copy, download et configure.
Ton des pages generees
Les pages de redirection generees doivent etre particulierement simples. Un visiteur peut devoir decider si une destination est sure, expiree, bloquee ou volontairement retardee. Ces etats doivent rester evidents.
Ton des badges
Le texte d’un badge doit rester court et reconnaissable. Si un badge demande plus d’explication, liez vers la documentation au lieu de forcer le badge a tout expliquer.