テクニカルライティング
created : / updated :
原則
技術文書では、読者につたえるべき内容は事実と意見に限られていて、心情的要素を含まない。無くてもすむ言葉は一つ残らず削ること。
アウトラインを作る
まずは文書で伝えたいことを箇条書きにする。その後、書き出した情報を整理する。それを起点に文書を書いていく。
序論について
序論の使命は、読者が抵抗なく本論にはいっていけるように準備を整えることである。
必要なのは、読者が本論を読むべきか否かを敏速・的確に判断するための材料を示すことと、本論にかかる前に必要な予備知識を読者に提供すること。
叙述の順序
何らかを説明する文章では、「概観から細部へ」という原則に重点がおかれる。文章の冒頭の短く要を得た記述によって概観がつかめれば、読者にとっては細分の記述を理解することが格段に容易になる。
文章
一連の文章は一貫した主語で書く（途中で主語を入れ替えない）。
一つの文を書くたびに、読者がそれをどういう意味に取るだろうかと、あらゆる可能性を検討する。