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

投稿日

技術文書

 

【この連載の前回:内容が明確に伝わる技術文書の書き方(その7)へのリンク】 

下図の「内容が明確に伝わる技術文書の書き方第1原則」は、技術文書を書くうえで最も重要な原則です。今回は、“ことわざ”と書き方の第1原則との関係の2回目です。

 

技術文書

 

1.己の欲せざる所は人に施す勿れ

例えば、報告書に以下のような書き方をした箇所があったらどうでしょうか。

 

【車の主な種類】

ハイブリッドとは、ガソリンで動くエンジンと、電気で動くモーターを搭載している車のことです。モーターがエンジンをサポートして走るため燃費がよく、ガソリン仕様車と比べて排出するCO2が軽減されるため、環境への影響が小さいのがこの車の特長です。コンパクトとは、ボディサイズが小さめで、排気量が小さなエンジンを積んだ車のことです。セダンやミニバンと比べてボディサイズが小さめなので取り回しがよく、狭い路地や駐車場でも気を使うことなく運転できることがこの車の特長です。セダンとは、エンジンルーム、乗車空間、荷物空間が別々になっている形をしていて、車の基本とも呼ばれるタイプの車のことです。乗車空間が荷物空間から独立していることから、乗る人の快適性を重視した居住空間が確保され、移動するのに適しているのがこの車の特長です。

筆者注:「車の主な種類」の内容は、「HONDA」のウェブサイトを参考にさせていただきました。

 

これを読むと、「文の羅列で書いてあるので内容がわかりにくい(内容が明確に伝わらない)。内容がわかりやすくなるように(内容が明確に伝わるように)、もう少し書き方を工夫してほしい。読み手のことを考えて書いてほしい」のような感想になると思います。

 

ここで参考になるのが、「己の欲せざる所は人に施す勿れ」という“ことわざ”です。「己の欲せざる所は人に施す勿れ」とは、自分がしてほしくないと思うことは、他人にとっても同じなのだから、他人にすべきではないという教えです。

 

これを、技術文書を書く場合に当てはめると、「自分が読んでわかりにくい(内容が明確に伝わらない)と思うような技術文書は、読み手にとってもわかりにくいはずだ。そのため、自分が読んでわかりにくいと思う技術文書を書くべきではない」という解釈になります。

 

つまり、「文の羅列で書いた内容を読み手の立場に立って読んでみるとわかりにくい(内容が明確に伝わらない)と思う。自分が読んでわかりにくい(内容が明確に伝わらない)のだから読み手にとってもわかりにくいだろう。そのため、文の羅列で内容を書くべきではない」という解釈になります。

 

前回と今回で紹介した「我が身をつねって人の痛さを知れ」と「己の欲せざる所は人に施す勿れ」という...

技術文書

 

【この連載の前回:内容が明確に伝わる技術文書の書き方(その7)へのリンク】 

下図の「内容が明確に伝わる技術文書の書き方第1原則」は、技術文書を書くうえで最も重要な原則です。今回は、“ことわざ”と書き方の第1原則との関係の2回目です。

 

技術文書

 

1.己の欲せざる所は人に施す勿れ

例えば、報告書に以下のような書き方をした箇所があったらどうでしょうか。

 

【車の主な種類】

ハイブリッドとは、ガソリンで動くエンジンと、電気で動くモーターを搭載している車のことです。モーターがエンジンをサポートして走るため燃費がよく、ガソリン仕様車と比べて排出するCO2が軽減されるため、環境への影響が小さいのがこの車の特長です。コンパクトとは、ボディサイズが小さめで、排気量が小さなエンジンを積んだ車のことです。セダンやミニバンと比べてボディサイズが小さめなので取り回しがよく、狭い路地や駐車場でも気を使うことなく運転できることがこの車の特長です。セダンとは、エンジンルーム、乗車空間、荷物空間が別々になっている形をしていて、車の基本とも呼ばれるタイプの車のことです。乗車空間が荷物空間から独立していることから、乗る人の快適性を重視した居住空間が確保され、移動するのに適しているのがこの車の特長です。

筆者注:「車の主な種類」の内容は、「HONDA」のウェブサイトを参考にさせていただきました。

 

これを読むと、「文の羅列で書いてあるので内容がわかりにくい(内容が明確に伝わらない)。内容がわかりやすくなるように(内容が明確に伝わるように)、もう少し書き方を工夫してほしい。読み手のことを考えて書いてほしい」のような感想になると思います。

 

ここで参考になるのが、「己の欲せざる所は人に施す勿れ」という“ことわざ”です。「己の欲せざる所は人に施す勿れ」とは、自分がしてほしくないと思うことは、他人にとっても同じなのだから、他人にすべきではないという教えです。

 

これを、技術文書を書く場合に当てはめると、「自分が読んでわかりにくい(内容が明確に伝わらない)と思うような技術文書は、読み手にとってもわかりにくいはずだ。そのため、自分が読んでわかりにくいと思う技術文書を書くべきではない」という解釈になります。

 

つまり、「文の羅列で書いた内容を読み手の立場に立って読んでみるとわかりにくい(内容が明確に伝わらない)と思う。自分が読んでわかりにくい(内容が明確に伝わらない)のだから読み手にとってもわかりにくいだろう。そのため、文の羅列で内容を書くべきではない」という解釈になります。

 

前回と今回で紹介した「我が身をつねって人の痛さを知れ」と「己の欲せざる所は人に施す勿れ」という“ことわざ”は相手のことを思いやる内容です。

 

書き方の3原則での第1原則(書き手と読み手の違いを認識する)も読み手のことを思いやる内容です。

 

次回に続きます。

 

【参考文献】

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

 

関連解説記事「相手の立場に立って考える」こと 

 

   続きを読むには・・・


この記事の著者

森谷 仁

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

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


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

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

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

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


物流現場管理を導入する 物流人財育成(その5)

  【物流人財育成 連載目次】 1.物流マンへの期待値 2.物流IEを育成する 3.物流技術スタッフを育成する 4.物流現場管理を...

  【物流人財育成 連載目次】 1.物流マンへの期待値 2.物流IEを育成する 3.物流技術スタッフを育成する 4.物流現場管理を...


概要版の一例 A3判の用紙1枚で業務の概要版を作成する方法(その2)

 今回の記事は、前回の記事(A3判の用紙1枚で業務の概要版を作成する方法(その1))の続きです。2回目は“4項目”と“...

 今回の記事は、前回の記事(A3判の用紙1枚で業務の概要版を作成する方法(その1))の続きです。2回目は“4項目”と“...


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

もっと見る
【SDGs取組み事例】事業性質にとらわれず、“SDGsに貢献可能なものは何か”を皆で考える エスティーティー株式会社(神奈川県秦野市)

【目次】 国内製造業のSDGs取り組み事例一覧へ戻る 1. 従業員の意識改革や職場環境の整備などに取り組む エスティーティー株式...

【目次】 国内製造業のSDGs取り組み事例一覧へ戻る 1. 従業員の意識改革や職場環境の整備などに取り組む エスティーティー株式...


人財教育・人材育成、仕事の影響力を高め、仕事の満足度を高めるには

【目次】 ▼さらに深く学ぶなら!「ビジネススキル」に関するセミナーはこちら! 1. 継続的に成果を出して仕事の影響力を高める 仕...

【目次】 ▼さらに深く学ぶなら!「ビジネススキル」に関するセミナーはこちら! 1. 継続的に成果を出して仕事の影響力を高める 仕...


社員教育:日頃の報連相

  1. VIP名簿の大切さ  ブランドメーカーのB社では、書類のファイリングや会議、面談、出張等のスケジューリング管理をすべて社長秘書が担当して...

  1. VIP名簿の大切さ  ブランドメーカーのB社では、書類のファイリングや会議、面談、出張等のスケジューリング管理をすべて社長秘書が担当して...