L'utilisation du mot « vous » dans un manuel utilisateur [fermé]

Question

Je suis en train d'écrire un manuel d'utilisation et je suis venu à une discussion avec un collègue. Il dit que je ne peux pas utiliser le mot « vous » partout dans le manuel. Je me souviens maintenant quelque chose à ce sujet à l'école, mais ce ne fut pas pour les procédures d'écriture. , Faire un peu je googler également observé que la plupart des tutoriels où l'utilisent beaucoup. Je préférerais l'utiliser, mais seulement si cela est considéré comme une bonne pratique. Que pensez-vous?

Answer 1

Certaines personnes croient que les manuels doivent être écrits comme si elles étaient des documents scientifiques. D'autres pensent que la précision technique et la lisibilité est plus important. Je suis de cette dernière persuasion - l'utilisation « vous » si elle correspond à votre style général, mais soyez cohérent dans votre utilisation - je trouver des documents qui passe entre « vous » et « nous » sont irritants (et c'est un péché que j'ai été coupable de moi-même).

Answer 2

Les alternatives que je connais sont:

• 'Vous' (deuxième personne du singulier) - "Vous devez mettre la plaque sur la table"
• Impératif - "Mettez la plaque sur la table"
• 'Nous' (première personne du pluriel) - "Il faut mettre la plaque sur la table"
• « L'utilisateur » (singulier de la troisième personne) - «L'utilisateur doit mettre la plaque sur la table »
• Passif - "La plaque doit être mis sur la table"

Mes préférences sont:

• Je préfère l'impératif que le mode par défaut, car il est le plus bref (moins verbiage).
• J'évite le passif, et la première personne du pluriel.
• J'utilise la deuxième personne pronom ( « vous ») ou d'une tierce personne nom (par exemple « votre administrateur système ») quand je veux un sujet explicite au lieu de l'impératif.

Answer 3

Ce qui est plus facile à comprendre?

  

Cliquez sur le bouton. Vous verrez une boîte de dialogue où vous pouvez saisir votre nom.

ou

  

L'action de cliquer sur le bouton provoque l'apparition d'une boîte de dialogue permettant la possibilité pour l'utilisateur d'entrer son nom.

Le premier est beaucoup plus facile à saisir. (En utilisant « vous » peut parfois être bâclée, mais qui a tendance à être dans les cas où il est utilisé comme un substitut à « un », ou « certaines personnes », ou « les gens en général ». Il est bien d'utiliser où vous êtes réellement se référant à la personne qui lit le texte.)

Answer 4

• Si voulez, vous pouvez éviter les vous de style par écrit dans le passive / style impératif. Vous pouvez essayez aussi l'approche « nous », mais peut sembler un peu enfantin. vous êtes faire le mal de rien avec vous en utilisant cependant.
• Pour éviter d'écrire dans le style que vous , utilisation le style passif / impératif. le nous-approche peut aussi travail , bien que il peut sembler un peu enfantin. Là est faux de rien avec vous en utilisant cependant.
• Nous peut éviter d'écrire dans le style que vous en employant le passif / impératif style. Ou nous pourrions utiliser le nous-approche, bien que nous pourrions sembler un peu enfantin. On pourrait essayer une approche, mais le risque de sondage et aliénant-lèvre supérieure raide le lecteur. Nous ne vous dérange pas en utilisant une fois dans un certain temps, cependant.

Je fais moi-même préférer la deuxième ligne. Une série de commandes est plus facile à suivre alors une histoire dans la forme que vous.

Answer 5

Vous devriez écrire explantions à la troisième personne.

  

Le Java flux modèle est un exemple de modèle classique décorateur.

Vous devriez écrire des instructions à la deuxième personne, mais même alors, il est toujours pas une bonne idée de se référer au lecteur comme « vous ».

  

Créer un constructeur qui peut initialiser les listes sur la base d'une liste donnée de listes.

Maintenant, comment avez-vous ressenti après avoir émis 2 commandes pour vous, mon lecteur?

Answer 6

Rédaction technique appliquer la règle de l'utilisation que du texte passif. ce qui signifie éviter « vous » être une bonne idée de rester dans le côté. qui est basé sur la façon dont je fais personnellement.

Answer 7

Je faire ce que Google, Microsoft, Yahoo, etc faire. Voici une page d'aide de Google au hasard:

http://mail.google.com/support /bin/answer.py?hl=en&answer=8494

montre que « vous » est utilisé. Vous pouvez vérifier la façon dont Microsoft écrit leur manuel d'utilisation aussi.

Comme une note de côté, je ne serais pas utiliser « je » ou « nous ».

Answer 8

Je pense que si vous fournissez des impératifs tels que « Ouvrir la porte », ou autrement adresser directement au lecteur, alors vous devrait utiliser « vous » au lieu de vous rendre plus difficile à comprendre en parlant à propos de certains utilisateurs abstrait.

Même dans les documents scientifiques, certains des plus écriture formelle que je peux penser, on peut se demander si oui ou non I , nous et d'autres première langue personne est autorisée. Autant que les enseignants du grammaire scolaire peut que vous pensiez autrement, il n'y a pas universellement régime approprié.

Answer 9

Je dirais juste faire attention. Il pourrait apparaître comme trop décontracté. Si le public visé est une affaire-y, je l'éviter. Cependant, si elle est un scénario d'utilisateur à la maison ou la commercialisation est occasionnel (pensez Southwest Airlines), je dirais aller avec elle.

Il suffit de faire abusez pas. Il devient alors la taxation sur le lecteur.

Exemple de la façon dont il est destiné à être utilisé?

Answer 10

Tout dépend du ton et le style de votre écriture. Approches formelles découragent l'utilisation de « vous ». Personnellement, j'aime d'utiliser un style concis, au point et relativement informel. Je n'ai aucun problème avec le « vous » mot lorsqu'il est utilisé avec parcimonie.

Évitez de trop l'utilisation comme dans:

Lorsque vous voulez commencer l'application que vous devez entrer votre mot de passe et vous devez sélectionner la fonction que vous souhaitez utiliser.

Answer 11

A partir du Manuel de rédaction technique. 8e édition (p. 262):

  

Vous pouvez faire des phrases plus courtes en laissant quelques articles (un, un, le), certains pronoms (vous, cela, ceux-ci), et quelques verbes, mais ces phrases peut entraîner style Telegraphics et être plus difficile à comprendre.

Alors, je dirais qu'il est OK pour que vous utilisez, mais comme Gilbert Le Blanc a dit dans son commentaire, il est souvent préférable d'écrire « puis cliquez sur le bouton » au lieu de « puis vous cliquez sur le bouton ».

Answer 12

forme impersonnelle doit être préférée. L'utilisation de « vous » serait trop claire, et la plupart de vos clients croire que vous n'êtes pas professionnel. Un manuel clair réduira également la nécessité d'un soutien à la clientèle post-vente et causent des pertes à la société.