マニュアル、レポート、ジャーナル記事などの技術文書を作成する必要があります。
最近、「This ” たくさんの時間。たとえば、
アンカーのGPS位置に1つのマーカーブイを配置し、フレームのGPS位置に別のマーカーブイを配置します。これにより、ナビゲートがはるかに簡単になります。
または
ログファイルは次のようになります。キャリブレーション設定およびその他のメタデータについて解析されます。非常に大きなファイルの場合、このプロセスには数分かかることがあります。
または
新しい電池を挿入した場合は、磁力計を再校正する必要があります。この操作は、スマートフォンのコンパスを使用するときによく必要となる再調整に似ています。
これらの文は大丈夫ですか、それとも読みやすい他の文の構成はありますか?そのまま受け入れて先に進む必要がありますか?
コメント
- 技術文書は、優雅さやより高度なスタイルではなく、明確にするために作成する必要があります。あなたが提供した例は明確であり、他の例よりも認知処理が少なくてすむと思います。私は彼らに固執して先に進むと言います。
- それはナビゲーションをはるかに簡単にします。それは何とかなるでしょう。そのようなものはナビゲーションを何とかします。確かに、本当に、ナビゲーションがはるかに簡単になるとあなたに言います。
回答
ありますこれまで行ってきたことを継続することの明確な利点。
これは、パターンの繰り返しです
アクションを実行するようにリーダーに指示します。
すぐに続いて
アクションの結果および/またはメリットに関する説明/コメント
読者の認知的負荷を軽減:さまざまな解釈の追加作業を実行する必要が常にあるわけではありません説明から指示を分類したり、それらの相互関係を理解したりするための、提示形式と文の構造の説明。
現在読んでいる情報を提示する方法ersを使用すると、何が期待されているのか、そしてその理由をすぐに知ることができます。
「これ」で始まる文の事実は、実際には、読者に、これから続くことはおそらく、実行するように依頼したアクションに関する説明またはコメントであるという有用なシグナルです。
資料の提示のこの側面は、技術文書が文芸小説と異なる重要な方法の1つです。
フィクション作家のスタイルによっては、フィクションを読む楽しみの一部が異なります。予想外の並置と小さなパズルに驚いたとき、それらのいくつかは、読者に資料を提示する方法を変えることによって作成されたり、より興味をそそられたりします。
あなたの場合、あなたは狙っています(またはそうあるべきです)。反対の結果:プレゼンテーションの予測可能性と読者の理解の明確さは密接に関係しています。文章の相対的な簡潔さとフォーマットの反復性により、意図しない曖昧さが生じる可能性が低くなります。
分単位で負担する価値がありますd技術文書のあいまいさを回避するための重要な理由の1つは、煩わしいだけでなく、読者が誤ったアクション(通電してはならない回路に通電するなど)を実行することに混乱した場合、危険または損害を与える可能性さえあります。
コメント
- @ geometrikal-それは'おそらく私のとがった耳とかわいい小さな鼻に嫉妬しています。
- すばらしい答え@ErikKowal。これが私が賛成した理由です:-)
回答
ほとんどすべての単語やフレーズは使いすぎですが、 1つの文でトピック(エージェント、「キャラクター」、または件名)に名前を付け、次の文で this を使用して参照することは、読者が文章をわかりやすく簡単に読むのに役立つ優れた方法です。これは、最も優れた文章の重要な文体要素であるトピック文字列の主要なタイプの例です。
通常、先行詞を1つ以上の句で長くすることで、より良い言い回しの方法を見つけることができる場合がありますが、特に複雑な資料を扱う場合は、長い文を少なくします。あなたの読者が処理するのを助けることができます。 (適切に構成された長い文には何の問題もありませんが、例の文のペアは、それらを組み合わせると考えられる方法よりも好きです。)
多くの会話を伴うフィクションでは、 saidという単語が何度も出現することがよくあります。これらを調べて、それらの多くを別の動詞(泣いた、つぶやいた、放出されたなど)に置き換えようとするのは自動的に良いことではありません。一部の単語は、繰り返しに気付かずに頻繁に繰り返されます。これ(!)は、意図した機能を適切かつ静かに実行するためです。
回答
すべての文は私には問題ないようです。ただし、2番目の文の先頭にある「this」を削除したい場合は、最初の文を少し書き直すことができます。
たとえば、
の代わりに、アンカーのGPS位置に1つのマーカーブイを配置し、フレーム。これにより、ナビゲートがはるかに簡単になります。
書き込み
1つのマーカーブイをアンカーのGPS位置と、フレームのGPS位置にある別の位置により、ナビゲートがはるかに簡単になります。
ログファイルは、キャリブレーション設定やその他のメタデータのために解析されます。非常に大きなファイルの場合、このプロセスには数分かかることがあります。
書き込み
キャリブレーション設定やその他のメタデータのログファイルの解析は、非常に大きなファイルの場合、数分かかる場合があります。
私の意見では、3番目の例がおそらく最良です
コメント
- ご存知のとおり、選択肢によって元の文のペアの意味が変わります。最初の変更は、元の機能の主な機能であるデプロイの指示を失います。 2番目の変更では、元の機能の主な機能が失われます。解析が行われることを通知します。
- 最初の変更では、受動態を使用できます。プロセスによってナビゲーションが簡単になります。しかし、最高の文ではありません。 2つ目は、"ファイルが非常に大きいと、このプロセスに数分かかる場合があります"?