Passer au contenu principal
Si vous ne pouvez pas consulter un guide de style complet, suivez ces conseils pour améliorer considérablement votre contenu.

​
Utiliser la voix active

É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.
PreferredDiscouraged
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.
PreferredDiscouraged
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).Vous pouvez consulter ce lien.

​
É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.
PreferredDiscouraged
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.
PreferredDiscouraged
Connectez-vous à votre compte.Connectez-vous à votre compte.
Auth0 traite les connexions.Auth0 traite les connexions.
Configurez votre matériel.Configurez votre matériel.
Décrivez votre configuration matérielle.Décrivez votre configuration matérielle.

​
Utiliser les lettres minuscules pour les entêtes

Mettez en majuscule uniquement la première lettre et tous les noms propres ou noms de produits Auth0.
PréféréDéconseillé
Ajouter une dépendanceAjouter une Dépendance
Valider une reprise de connexionValider une Reprise de Connexion
Créer une ActionCréer une action

​
Utiliser l’indicatif présent pour les entêtes

Évitez toute redondance inutile en utilisant des temps verbaux simples pour les entêtes.
PreferredDiscouraged
Affecter et modifier des utilisateursAffectaction et modification des utilisateurs
Connecter une base de données personnaliséeComment connecter une base de données personnalisée

​
Rédiger les étapes de manière concise

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.
PreferredDiscouraged
Pour installer la trousse SDK :Suivez les étapes ci-dessous :

​
Définir les attentes des utilisateurs dans les étapes

Informez les utilisateurs de ce que devrait être le résultat de leur comportement avant de décrire le comportement à adopter.
PreferredDiscouraged
Pour activer cette intégration, sélectionnez Enregistrer les modifications.Sélectionnez Enregistrer les modifications pour activer cette intégration.

​
Énumérer les actions dans les étapes dans l’ordre

À chaque étape, indiquez à l’utilisateur ce qu’il doit faire dans l’ordre où il doit le faire.
PréféréDéconseillé
Repérez la section Integrations , et sélectionnez Ajouter une intégration.Sélectionnez Ajouter une intégration sous la section Integrations.

​
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.

​
En savoir plus