ユーザーマニュアルで「あなた」という言葉を使用して[閉じた

Question

私はユーザーマニュアルを書いていますが、同僚と話し合いました。彼は、マニュアルのどこにも「あなた」という言葉を使うことはできないと言います。今、私は学校でこれについて何かを覚えていますが、それは手順を書くためではありませんでした。また、いくつかのグーグルを行うと、ほとんどのチュートリアルがそれをよく使用していることを観察しました。私はそれを使用することを好みますが、これが良い習慣と見なされる場合のみです。どう思いますか？

Answer 1

一部の人々は、マニュアルはまるで科学論文であるかのように書かれるべきであると信じています。他の人は、技術的な正確性と読みやすさがより重要であると信じています。私は後者の説得です - それがあなたの全体的なスタイルに合うなら「あなた」を使用しますが、あなたの使用法に一貫しています - 私は「あなた」と「私たち」の間に切り替える文書を見つけます（そしてそれは私が私が罪です私自身の罪を犯しました）。

Answer 2

私が知っている選択肢は次のとおりです。

• 「あなた」（2人目の単数） - 「プレートをテーブルに置くべきです。」
• 命令的 - 「プレートをテーブルに置いてください。」
• 「私たち」（一人称複数） - 「プレートをテーブルに置くべきです。」
• 「ユーザー」（三人称単数） - 「ユーザーはテーブルにプレートを置く必要があります。」
• パッシブ - 「プレートをテーブルに置く必要があります。」

私自身の好みは次のとおりです。

• デフォルトモードとしての命令を好みます。これは、最も短い（最小言語）です。
• 私は受動的で、最初の人が複数を避けます。
• 命令の代わりに明示的な主題が必要なときに、2人目の代名詞（「あなた」）または第三者名詞（「システム管理者」など）を使用します。

Answer 3

理解しやすいですか？

ボタンをクリックします。名前を入力できるダイアログボックスが表示されます。

また

ボタンをクリックすると、ダイアログボックスが表示されると、ユーザーが名前を入力できるようになります。

1つ目は把握しやすいです。 （「あなた」を使用することは時々ずさんなものになる可能性がありますが、それは「1つ」、「一部の人」、または「一般的な人々」の代替品として使用される場合にはありがあります。テキストを読んでいる人を参照してください。）

Answer 4

• もしも 君 パッシブ/命令的なスタイルで書くことで、あなたはスタイルを避けることができます。 「私たち」のアプローチを試すこともできますが、それは少し幼稚に聞こえるかもしれません。あなたはあなたを使うことで何も悪いことをしていません。
• 避けるために あなたのスタイルで書く、使用する 受動的/命令的なスタイル。私たちのアプローチ そうかもしれない また 仕事, 、それは少し幼稚に聞こえるかもしれませんが。しかし、あなたを使うことに何の問題もありません。
• 我々 受動的/命令的なスタイルを採用することで、あなたのスタイルで書くことを避けることができます。または、私たちは少し幼稚に聞こえるかもしれませんが、私たちは私たちのアプローチを使用することもできます。 1つのアプローチを試すこともできますが、硬いアッパーリップに響き、読者を疎外するリスクがあります。 我々 しかし、たまにあなたを使っても気にしないでください。

私自身は2行目を好みます。一連のコマンドは、You-Formのストーリーよりも簡単に従うことができます。

Answer 5

あなたは第三者に外植物を書くべきです。

Java Streamsモデルは、古典的なデコレーターパターンの例です。

2番目の人に指示を書くべきですが、それでも読者を「あなた」と呼ぶことはまだ良い考えではありません。

初期化できるコンストラクターを作成します リスト 特定のリストのリストに基づいています。

さて、私の読者、あなたに2つのコマンドを発行した後、あなたはどのように感じましたか？

Answer 6

テクニカルライティングは、パッシブテキストのみを使用するというルールを実施します。 「あなた」を避けることは、安全な側にとどまることをお勧めします。それは私が個人的にそれをする方法に基づいています。

Answer 7

私はGoogle、Microsoft、Yahooなどをすることをします。これがGoogleのランダムヘルプページです：

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

「あなた」が使用されていることを示しています。 Microsoftがユーザーマニュアルをどのように書いているかを確認できます。

サイドノートとして、私は「私」や「私たち」を使用しません。

Answer 8

「ドアを開ける」などの必須事項を提供している場合、または読者に直接対処する場合、あなたは したほうがいい 抽象的なユーザーについて話すことで、自分自身をより困難にするのではなく、「あなた」を使用してください。

科学論文でさえ、私が考えることができる最も正式な執筆のいくつかは、それは議論の余地があるかどうかは議論の余地があります 私, 私たち そして、他の一人称言語は許されます。高校の文法教師がそうではないと思うことを好むかもしれませんが、普遍的に適切なスキームはありません。

Answer 9

気をつけてください。それはあまりにもカジュアルに出くわすかもしれません。意図した視聴者がビジネスの場合、私はそれを避けます。ただし、ホームユーザーのシナリオであるか、マーケティングがカジュアルである場合（サウスウエスト航空会社を考えてください）、私はそれと一緒に行くと思います。

使いすぎないでください。その後、読者に課税されます。

どのように使用することを意図しているかのサンプル？

Answer 10

それはすべてあなたの文章のトーンとスタイルに依存します。正式なアプローチは、「あなた」の使用を思いとどまらせます。個人的には、私は簡潔で、ポイントまで、比較的非公式なスタイルを使用するのが好きです。控えめに使用したとき、私は「あなた」の言葉に問題はありません。

のように過剰な使用を避けてください：

アプリケーションを起動する場合は、パスワードを入力する必要があり、使用する関数を選択する必要があります。

Answer 11

テクニカルライティングのハンドブックから。第8版（p。262）：

いくつかの記事（a、an、the）、いくつかの代名詞（あなた、これ、これら）、およびいくつかの動詞を除外することで文を短くすることができますが、そのような文章は電信スタイルになり、理解するのが難しい場合があります。

だから、私はあなたを使っても大丈夫だと思いますが、ギルバート・ル・ブランが彼のコメントで言ったように、「ボタンをクリックする」ではなく「ボタンをクリックして」と書く方が良いことが多いです。

Answer 12

非人格的な形を好むべきです。 「あなた」の使用はあまりにも明確であり、あなたのクライアントのほとんどはあなたが専門的ではないと信じています。また、明確なマニュアルは、販売後の顧客サポートの必要性を減らし、会社に損失を引き起こします。