Liste de mots recommandés
Pour aider à assurer la cohérence de la documentation, l'équipe de rédaction technique recommande ces choix de mots.
& (esperluette)
N'utilisez pas &
à la place de et
dans les en-têtes, le texte, la navigation, le texte de l'interface utilisateur ou les tables des matières.
ci-dessus
Essayez d'éviter d'utiliser ci-dessus
en vous référant à un exemple ou à un tableau dans une page de documentation. Si nécessaire, utilisez précédent
à la place.
Par exemple :
Dans l'exemple précédent, le chien avait des puces.
nom de compte
Ne pas utiliser. Utilisez plutôt nom d'utilisateur
.
admin
Écrivez administrateur
lors de la première utilisation. Utilisez admin
s'il s'agit du nom d'une étiquette d'interface utilisateur ou d'un autre élément.
permet
Ne pas utiliser. Utilisez plutôt laisse
.
au moment de la rédaction
Évitez car la rédaction elle-même implique cette phrase. La phrase peut également partager prématurément la stratégie d'un produit ou d'une fonctionnalité ou impliquer de manière inappropriée qu'un produit ou une fonctionnalité pourrait changer.
ci-dessous
Essayez d'éviter ci-dessous
en vous référant à un exemple ou à un tableau sur une page de documentation. Si nécessaire, utilisez suivant
à la place.
Par exemple :
Dans l'exemple suivant, le chien avait des puces.
case à cocher
Utilisez un mot pour case à cocher
. N'utilisez pas boîte à cocher
.
Vous sélectionnez
(et non cochez
ou activez
) et décochez
(et non désélectionnez
ou désactivez
) les cases à cocher.
cliquer
N'utilisez pas cliquer
. Utilisez plutôt sélectionner
avec les boutons, les liens, les éléments de menu et les listes.
Sélectionner
s'applique à plus d'appareils, tandis que cliquer
est plus spécifique à une souris.
actuellement
N'utilisez pas actuellement
en parlant du produit ou de ses fonctionnalités. La documentation décrit le produit tel qu'il est aujourd'hui.
désactiver
N'utilisez pas désactiver
. Implique que le handicap est un état moins souhaité ou négatif.
Utilisez plutôt éteindre
ou désactiver
.
Il y a des moments avec des fonctionnalités plus techniques où l'équipe de développement utilise désactiver
, et dans ces cas, il est acceptable d'utiliser le terme.
antérieur
Utilisez antérieur
en parlant des numéros de version.
Utilisez :
Dans Docker Desktop 4.1 et antérieur.
Au lieu de :
Dans Docker Desktop 4.1 et inférieur.
facile, facilement
Ce qui peut être facile pour vous peut ne pas l'être pour les autres. Essayez d'éliminer ce mot de la phrase car généralement le même sens peut être transmis sans lui.
par ex.
Ne pas utiliser. Utilisez plutôt des phrases comme par exemple
ou tel que
.
activer
N'utilisez pas activer
. Implique que le handicap est un état moins souhaité ou négatif.
Utilisez plutôt allumer
ou activer
.
Il y a des moments avec des fonctionnalités plus techniques où l'équipe de développement utilise activer
, et dans ces cas, il est acceptable d'utiliser le terme.
exécuter
Évitez si possible. Utilisez lancer
à la place.
ultérieur
Utilisez ultérieur
en parlant des numéros de version.
Utilisez :
Dans Docker Desktop 4.1 et ultérieur.
Au lieu de :
Dans Docker Desktop 4.1 et supérieur… ou Dans Docker Desktop 4.1 et ci-dessus…
s'il vous plaît
N'utilisez pas s'il vous plaît
dans le cours normal de l'explication de l'utilisation d'un produit, même si vous expliquez une tâche difficile. N'utilisez pas non plus la phrase veuillez noter
.
s'inscrire
Utilisez créer un compte
au lieu de s'inscrire en parlant de la création d'un compte.
repo
Ne pas utiliser. Utilisez plutôt dépôt
.
respectivement
Évitez respectivement
et soyez plus précis à la place.
faire défiler
Évitez. Utilisez une expression verbale comme parcourir
ou naviguer vers
à la place, si le contexte est clair.
se connecter
Utilisez se connecter
au lieu de s'identifier
, log on
, logon
, ou log in
, login
. Si l'interface utilisateur utilise des mots différents, utilisez ceux-là.
Utilisez se connecter à
au lieu de se connecter dans
.
s'inscrire
Utilisez s'inscrire
ou créer un compte
au lieu de s'enregistrer
en parlant de la création d'un compte.
onglet versus vue
Utilisez vue
en vous référant à une section majeure d'une interface utilisateur. Utilisez onglet
en vous référant à une sous-section de l'interface utilisateur.
Par exemple, dans Docker Desktop, la vue Images et l'onglet Local.
basculer
Vous activez ou désactivez un interrupteur. Par exemple :
Activez le mode sombre.
mettre à niveau
Utilisez mettre à niveau
pour décrire un niveau d'abonnement supérieur
vs
N'utilisez pas vs
ou vs.
comme abréviation de versus ; utilisez plutôt le mot versus
non abrégé.
nous
Essayez d'éviter nous
et concentrez-vous plutôt sur la façon dont l'utilisateur peut accomplir quelque chose dans Docker.
Utilisez :
Utilisez des widgets lorsque vous avez du travail à organiser.
Au lieu de :
Nous avons créé une fonctionnalité pour que vous puissiez ajouter des widgets.
souhaiter
Ne pas utiliser. Utilisez vouloir
à la place.