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

投稿日

技術文書

 

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

1.「技術文書を書くこと」についての整理

これまで、「技術文書を書くこと」を以下の視点で解説しました。

  • ①技術文書=コミュニケーションの手段 (技術文書を書くこと:その1)
  • ②技術文書を書く目的 (技術文書を書くこと:その2)
  • ③「内容が伝わる」と「内容が“明確に”伝わる」の違い (技術文書を書くこと:その2)
  • ④内容が明確に伝わる技術文書 (技術文書を書くこと:その2)
  • ⑤内容が明確に伝わる技術文書を書く理由 (技術文書を書くこと:その3)

技術文書を書く目的は、「技術文書の書き手からその読み手に内容を伝達すること」です。「技術文書=コミュニケーションの手段」と考えると「内容が明確に伝わる技術文書」を書くことの重要性がわかります。

 

内容が明確に伝わる技術文書を書くうえでのポイントの一つは、書き手と読み手の違いを認識して読み手の立場に立って書くことです。これは重要な内容なので別途解説します。

 

2.内容を伝達する意識を持つ

「内容を伝達するために技術文書を書く」という意識で技術文書を書いてください。例えば、業務報告書を書くことを考えます。業務を行ったときには業務の最後にその報告書を書きます。このとき、「業務の成果をまとめる」あるいは「業務の成果を記録として残す」という意識で業務報告書を書くと思います。しかし、このような意識ではなく、「業務の成果(内容)を伝達するために業務報告書を書く」という意識で業務報告書を書いてください。

 

内容を伝達する意識を持つと技術文書を書く意識が変わります。例えば、「業務の成果(内容)を伝達するために業務報告書を書く」という意識を持つと業務報告書の書き方が変わります。「まとめる」あるいは「記録として残す」ではなく「業務の成果(内容)を伝達する」という意識に変わるからです。「業務の成果(内容)を伝達するためには業務報告書をどのように書いたらよいか」と考えます。

 

これは、他の技術文書、例えば、会議・打ち合わせの資料やメールを書くときも同じです。「技術文書=コミュニケーションの手段」と考えて「内容を...

技術文書

 

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

1.「技術文書を書くこと」についての整理

これまで、「技術文書を書くこと」を以下の視点で解説しました。

  • ①技術文書=コミュニケーションの手段 (技術文書を書くこと:その1)
  • ②技術文書を書く目的 (技術文書を書くこと:その2)
  • ③「内容が伝わる」と「内容が“明確に”伝わる」の違い (技術文書を書くこと:その2)
  • ④内容が明確に伝わる技術文書 (技術文書を書くこと:その2)
  • ⑤内容が明確に伝わる技術文書を書く理由 (技術文書を書くこと:その3)

技術文書を書く目的は、「技術文書の書き手からその読み手に内容を伝達すること」です。「技術文書=コミュニケーションの手段」と考えると「内容が明確に伝わる技術文書」を書くことの重要性がわかります。

 

内容が明確に伝わる技術文書を書くうえでのポイントの一つは、書き手と読み手の違いを認識して読み手の立場に立って書くことです。これは重要な内容なので別途解説します。

 

2.内容を伝達する意識を持つ

「内容を伝達するために技術文書を書く」という意識で技術文書を書いてください。例えば、業務報告書を書くことを考えます。業務を行ったときには業務の最後にその報告書を書きます。このとき、「業務の成果をまとめる」あるいは「業務の成果を記録として残す」という意識で業務報告書を書くと思います。しかし、このような意識ではなく、「業務の成果(内容)を伝達するために業務報告書を書く」という意識で業務報告書を書いてください。

 

内容を伝達する意識を持つと技術文書を書く意識が変わります。例えば、「業務の成果(内容)を伝達するために業務報告書を書く」という意識を持つと業務報告書の書き方が変わります。「まとめる」あるいは「記録として残す」ではなく「業務の成果(内容)を伝達する」という意識に変わるからです。「業務の成果(内容)を伝達するためには業務報告書をどのように書いたらよいか」と考えます。

 

これは、他の技術文書、例えば、会議・打ち合わせの資料やメールを書くときも同じです。「技術文書=コミュニケーションの手段」と考えて「内容を伝達する」という意識で技術文書を書いてください。

 

次回から、「内容が明確に伝わる技術文書の書き方」について解説します。

 

【参考文献】

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

 

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

 

   続きを読むには・・・


この記事の著者

森谷 仁

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

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


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

もっと見る
なりきり会議とは、会議室は、笑顔と笑い声、そしてアイデアが広がる!

   【目次】 ▼さらに深く学ぶなら!「行動科学」に関するセミナーはこちら! ▼さらに幅広く学ぶなら!「分野別の...

   【目次】 ▼さらに深く学ぶなら!「行動科学」に関するセミナーはこちら! ▼さらに幅広く学ぶなら!「分野別の...


 「行動できない理由」を学ぶ、人はなぜ行動を後回しにするのか?

  【目次】 ▼さらに深く学ぶなら!「行動科学」に関するセミナーはこちら! ▼さらに幅広く学ぶなら!「分野別のカリキュラム...

  【目次】 ▼さらに深く学ぶなら!「行動科学」に関するセミナーはこちら! ▼さらに幅広く学ぶなら!「分野別のカリキュラム...


知って得する人的資源マネジメント、熟達、6つの美徳と24の徳性【連載記事紹介】 

   【目次】 ◆ 熟達とは 前回の知って得する人的資源マネジメント、自律性【連載記事紹介】では、内発的動機づけ...

   【目次】 ◆ 熟達とは 前回の知って得する人的資源マネジメント、自律性【連載記事紹介】では、内発的動機づけ...


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

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

従業員主体で環境保護、サステナビリティへの取り組み SDGs(持続可能な開発目標)の観点からみても重要な取り組みとして注目されている「エコチューニン...

従業員主体で環境保護、サステナビリティへの取り組み SDGs(持続可能な開発目標)の観点からみても重要な取り組みとして注目されている「エコチューニン...


『わかりにくい案内図』から学ぶこと

1. 案内図の表示が上下逆さま  弊社は埼玉県所沢市にあります。昨年の夏頃、所沢駅西口の駅前の交差点に写真①のような案内板が設置されました。この案内...

1. 案内図の表示が上下逆さま  弊社は埼玉県所沢市にあります。昨年の夏頃、所沢駅西口の駅前の交差点に写真①のような案内板が設置されました。この案内...


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

  やろうと思っているけどできないことってありますね。ぼくもやろうと思っていることがたくさんあるのにできないことばかりです。コーチングでもよく...

  やろうと思っているけどできないことってありますね。ぼくもやろうと思っていることがたくさんあるのにできないことばかりです。コーチングでもよく...