“技術文書を書くこと”について考える(その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を選んだこと(内容)が明確に伝わります。「内容が明確に伝わる」とは、内容がはっきりと伝わることです。

 

「内容が明確に伝わる技術文書」とは、「内容がはっきりと伝...

技術文書

 

【この連載の前回:“技術文書を書くこと”について考える(その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日

 

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

 

   続きを読むには・・・


この記事の著者

森谷 仁

「君の書く文書は、わかりにくい」と言われる技術者から、「君の書く文書は、わかりやすい」と言われる技術者へのステップアップ!

「君の書く文書は、わかりにくい」と言われる技術者から、「君の書く文書は、わかりやすい」と言われる技術者へのステップアップ!


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

もっと見る
OJCCとは(8)忠誠心の育成 【快年童子の豆鉄砲】(その108)

  1. 忠誠心の育成 これまで説明してきたのは、仕事に必要な“能力”(「仕事に関する知識(B)」と「技能者・技...

  1. 忠誠心の育成 これまで説明してきたのは、仕事に必要な“能力”(「仕事に関する知識(B)」と「技能者・技...


1on1 ミーティングの成果を高めるコツとは

  部下や後輩の話に耳を傾け、フィードバックをすることで、相手のモチベーションを高めると共にワークエンゲージメントを高めることもできる、1...

  部下や後輩の話に耳を傾け、フィードバックをすることで、相手のモチベーションを高めると共にワークエンゲージメントを高めることもできる、1...


頭の中を整理する 内容が明確に伝わる技術文書の書き方(その34)

     「内容が明確に伝わる技術文書の書き方(その30)」で「必要なこと」として「伝える内容を明確に理解していること」...

     「内容が明確に伝わる技術文書の書き方(その30)」で「必要なこと」として「伝える内容を明確に理解していること」...


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

もっと見る
加工現場のエースになるための7つの心構え

【目次】 1、加工現場のエースになるための心得とは  (1) 今ここにいる全員がいなくなっても、ものづくりができる準備をしている  (2) 次は...

【目次】 1、加工現場のエースになるための心得とは  (1) 今ここにいる全員がいなくなっても、ものづくりができる準備をしている  (2) 次は...


人材の課題 伸びる金型メーカーの秘訣 (その20)

 今回、取り上げる金型メーカーは、I 精機株式会社です。同社は、高い職人技術で、金型製作から試作板金、部品加工まで幅広く手がけてきましたが、今後はその職人...

 今回、取り上げる金型メーカーは、I 精機株式会社です。同社は、高い職人技術で、金型製作から試作板金、部品加工まで幅広く手がけてきましたが、今後はその職人...


やろうと思っているけどできないことばかり、の克服(その3)

 やろうと思っているけどできないことでモヤモヤしている気持ち。そんな気持ちを克服する方法の3回目です。    これまで紹介したのは次のステッ...

 やろうと思っているけどできないことでモヤモヤしている気持ち。そんな気持ちを克服する方法の3回目です。    これまで紹介したのは次のステッ...