Évitez la voix passive (verbe être + verbe au passé). Pour rendre votre texte plus dynamique, clair et (souvent) plus court, essayez d’utiliser des acteurs et la voix active autant que possible.
Preferred
Discouraged
Une fois que vous avez ajouté la configuration requise, Auth0 traitera toutes les connexions pour votre locataire en utilisant cette règle. Avant d’activer l’intégration en production, assurez-vous d’avoir configuré correctement tous les composants et vérifié sur un locataire de test.
Une fois la configuration requise ajoutée, toutes les connexions de votre locataire seront traitées par cette règle. Veuillez vous assurer que tous les composants ont été configurés correctement et vérifiés sur un locataire de test avant d’activer l’intégration dans la production.
Lorsque vous créez des liens vers d’autres ressources, assurez-vous que le lien décrit l’action ou la tâche dans le document vers lequel le lien pointe. Le texte de lien générique réduit la facilité de numérisation en obligeant les lecteurs à lire tout le texte entourant un lien pour identifier ce qu’ils doivent sélectionner.
Preferred
Discouraged
Vous pouvez utiliser ou pour [personnaliser le texte pour la nouvelle expérience de connexion universelle] (/docs/customize/universal-login-pages/universal-login-page-templates).
Cliquez [ici] (/docs/get-started).
Pour apprendre comment attribuer des rôles aux membres d’organisations, lisez [Ajouter des rôles aux membres d’organisation] (/docs/manage-users/organizations/configure-organizations/add-member-roles).
Écrire des instructions adaptées à tous les appareils
N’oubliez pas que les interfaces utilisateur s’affichent différemment sur différents appareils. De plus, gardez à l’esprit que les utilisateurs peuvent utiliser des appareils adaptatifs pour consulter votre contenu.
Preferred
Discouraged
Sélectionnez Create (Créer).
Cliquez sur Create (Créer).
Passez à la vue Applications.
Passez à l’onglet Applications.
Localisez le (Secret client).
Faites défiler l’écran vers le haut jusqu’au Client Secret (Secret client).
Utiliser correctement les verbes et noms/adjectifs
Faites attention aux mots qui peuvent être utilisés à la fois comme verbes et comme noms ou adjectifs. Les formes verbales nécessitent généralement un espace entre les mots, tandis que les noms et les adjectifs peuvent être composés.
Lorsque vous rédigez le texte d’introduction des étapes, soyez direct et concis. Gardez à l’esprit que les utilisateurs savent déjà ce qu’ils doivent faire avec une liste numérotée d’étapes.
Utiliser les notes et avertissements de manière adéquate
Les notes et les avertissements ont des fonctions différentes. Les notes doivent inclure des informations générales qu’il serait utile de connaître, tandis que les avertissements contiennent des informations pouvant entraîner un échec si elles ne sont pas suivies.S’il vaut la peine que des informations soient présentées comme un avertissement, vous devriez le placer précisément là où l’utilisateur doit effectuer l’action correspondante. Les utilisateurs ne devraient pas avoir à chercher les avertissements.
