“技術文書を書くこと”について考える(その2)

投稿日

...

技術文書

 

【この連載の前回:“技術文書を書くこと”について考える(その1)へのリンク】 

1.技術文書を書く目的

技術文書を書く目的とは、技術文書の書き手からその読み手に内容を伝達することです。内容とは、書き手が読み手に伝えることです。例えば、仕事の成果、会議や打ち合わせで説明すること、提案や企画の内容、メールで伝えることなどです。書き手はこれらのことを読み手に伝達するため(伝えるため)に技術文書を書きます。

 

2.「内容が伝わる」と「内容が“明確に”伝わる」の違い

「内容が明確に伝わる技術文書」を書くことで技術文書を書く目的が達成できます。ここでは、「内容が伝わる」と「内容が“明確に”伝わる」の違いを解説します。以下の2つの文章を比べてください。

  • Ⅰ:製品Aと製品Bと製品Cの比較の結果、製品Aを選んだ。3つの中で製品Aが最もよかったからだ。
  • Ⅱ:製品Aと製品Bと製品Cの比較の結果、製品Aを選んだ。3つの中で、製品Aは形がシンプルで色も美しくかつ最も使いやすかったからだ。

 

Ⅰの文章が、「『内容が伝わる』文章」です。書き手がAを選んだこと、すなわち、内容は伝わります。しかし、Aを選んだ具体的な根拠が書いてありません。そのため、この文章を読んだ人は、「何でAを選んだのだろうか、自分だったらBを選ぶと思う。他の人もBあるいはCを選ぶと思う」とこの文章に疑問を持つかもしれません。これでは、読み手がAを選んだこと(内容)が明確に伝わりません。「内容が伝わる」とは、内容がぼんやりと伝わることです。

 

Ⅱの文章が、「『内容が“明確に”伝わる』文章」です。書き手がAを選んだこととAを選んだ具体的な根拠が書いてあります。このような文章であれば、「なるほど、書き手がAを選んだ根拠がわかった。自分だったらBを選ぶと思う。しかし、書き手は自分と違った視点でAを選んだのか」と思いAを選んだこと(内容)が明確に伝わります。「内容が明確に伝わる」とは、内容がはっきりと伝わることです。

 

「内容が明確に伝わる技術文書」とは、「内容がはっきりと伝わる技術文書」と言い換えることができます。

 

次回に続きます。

【参考文献】

森谷仁著、「マンガでわかる技術文書の書き方」、オーム社、令和4年3月25日

 

◆関連解説記事「書くべきことを自分の頭の中ではっきりさせる」 

 

   続きを読むには・・・


「人財教育・育成」の他のキーワード解説記事

もっと見る
「相手の立場に立って考える」こと

 2018年4月10日に掲載された記事のテーマは「『お客様のことを考えて文書を書く』とは」でした。この記事の冒頭で、「わかりやすい文書を書くうえで最も重要...

 2018年4月10日に掲載された記事のテーマは「『お客様のことを考えて文書を書く』とは」でした。この記事の冒頭で、「わかりやすい文書を書くうえで最も重要...


ジョブスキル教育 教育研修の進め方(その2)

【教育研修の進め方 連載目次】 1.  教育制度を見直す必要 2.  ジョブスキル教育 3.  階層別教育 4....

【教育研修の進め方 連載目次】 1.  教育制度を見直す必要 2.  ジョブスキル教育 3.  階層別教育 4....


内容が明確に伝わる技術文書の書き方(その37)

  「内容が明確に伝わる技術文書の書き方(その36)」で、日々のオンザジョブトレーニングでの「会話を通したトレーニング」の概要を解説しまし...

  「内容が明確に伝わる技術文書の書き方(その36)」で、日々のオンザジョブトレーニングでの「会話を通したトレーニング」の概要を解説しまし...


「人財教育・育成」の活用事例

もっと見る
伝えることの難しさ

1. 自分では当たり前でも、相手にとっては当たり前ではないことだらけ  人前で話をする機会が増えましたが、その都度、話すこと、伝えることの難しさを感...

1. 自分では当たり前でも、相手にとっては当たり前ではないことだらけ  人前で話をする機会が増えましたが、その都度、話すこと、伝えることの難しさを感...


クラフト体験を技術者教育に活用(クラフト・ミー)

【特集】ものづくりの現場から一覧へ戻る ものづくりを現場視点で理解する「シリーズ『ものづくりの現場から』」では、現場の課題や課題解消に向けた現場の取り組...

【特集】ものづくりの現場から一覧へ戻る ものづくりを現場視点で理解する「シリーズ『ものづくりの現場から』」では、現場の課題や課題解消に向けた現場の取り組...


【SDGs取り組み事例】自然と社会との共生を目指して 日本テクノ株式会社

従業員主体で環境保護、サステナビリティへの取り組み 日本テクノ株式会社(東京都新宿区) SDGs(持続可能な開発目標)の観点からみても重要な取り組...

従業員主体で環境保護、サステナビリティへの取り組み 日本テクノ株式会社(東京都新宿区) SDGs(持続可能な開発目標)の観点からみても重要な取り組...