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

投稿日

技術文書

 

「6つのルールと18の書き方」に関し「6つのルール」および「18の書き方」の概要について解説しています。「6つのルールと18の書き方」を以下に示します。「内容が明確に伝わる技術文書の書き方(その12)から(その18)」で「6つのルールと18の書き方」の具体的な使い方の一例を解説しました。今回は、わかりにくい書き方に気が付くを解説します。

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

人財教育

 

1.「わかりにくい(内容が明確に伝わらない)書き方」に気が付く

「内容が明確に伝わる技術文書の書き方(その8)」の記事の中で以下のことを書きました。

 

自分が読んでわかりにくい(内容が明確に伝わらない)と思うような技術文書は、読み手にとってもわかりにくいはずだ。そのため、自分が読んでわかりにくいと思う技術文書を書くべきではない。

 

このような認識を持つためには、自分が書いた技術文書を読み返したとき「この部分のこの書き方はわかりにくい(内容が明確に伝わらない)」ということに気が付く必要があります。例えば、「内容が明確に伝わる技術文書の書き方(その8)」の記事で書いたような文の羅列で書いてある内容を読んだとき、「文の羅列で書いてあるとわかりにくい(内容が明確に伝わらない)」と気が付くことです。

 

書いた内容を確認するだけは、「この書き方はわかりにくい(内容が明確に伝わらない)」ということに気が付きません。書いた内容の確認とともに「明確に伝わるかどうか」という確認も必要です。

 

つまり、技術文書を書いたら「自分が読み手だったらこの書き方でわかるか(内容が明確に伝わるか)」という視点での書き方の確認が必要です。

 

「この書き方はわかりにくい(内容が明確に伝わらない)」と気が付くためには、「どのような書き方をしたらわかりにくいか」という「わかりにくい」に対する判断基準が必要です。判断基準がないと、自分が書いた技術文書を読み返しても「わかりにくい(内容が明確に伝わらない)書き方」に気が付きません。

 

判断基準があることで、「わかりにくい(内容が明確に伝わらない)書き方」に気が付きます。

 

【参考】
今回の記事の内容に関係した記事を2018年1月10日に掲載しました。「『わかりにくい案内図』から学ぶこと」というテーマの記事です。「自分が...

技術文書

 

「6つのルールと18の書き方」に関し「6つのルール」および「18の書き方」の概要について解説しています。「6つのルールと18の書き方」を以下に示します。「内容が明確に伝わる技術文書の書き方(その12)から(その18)」で「6つのルールと18の書き方」の具体的な使い方の一例を解説しました。今回は、わかりにくい書き方に気が付くを解説します。

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

人財教育

 

1.「わかりにくい(内容が明確に伝わらない)書き方」に気が付く

「内容が明確に伝わる技術文書の書き方(その8)」の記事の中で以下のことを書きました。

 

自分が読んでわかりにくい(内容が明確に伝わらない)と思うような技術文書は、読み手にとってもわかりにくいはずだ。そのため、自分が読んでわかりにくいと思う技術文書を書くべきではない。

 

このような認識を持つためには、自分が書いた技術文書を読み返したとき「この部分のこの書き方はわかりにくい(内容が明確に伝わらない)」ということに気が付く必要があります。例えば、「内容が明確に伝わる技術文書の書き方(その8)」の記事で書いたような文の羅列で書いてある内容を読んだとき、「文の羅列で書いてあるとわかりにくい(内容が明確に伝わらない)」と気が付くことです。

 

書いた内容を確認するだけは、「この書き方はわかりにくい(内容が明確に伝わらない)」ということに気が付きません。書いた内容の確認とともに「明確に伝わるかどうか」という確認も必要です。

 

つまり、技術文書を書いたら「自分が読み手だったらこの書き方でわかるか(内容が明確に伝わるか)」という視点での書き方の確認が必要です。

 

「この書き方はわかりにくい(内容が明確に伝わらない)」と気が付くためには、「どのような書き方をしたらわかりにくいか」という「わかりにくい」に対する判断基準が必要です。判断基準がないと、自分が書いた技術文書を読み返しても「わかりにくい(内容が明確に伝わらない)書き方」に気が付きません。

 

判断基準があることで、「わかりにくい(内容が明確に伝わらない)書き方」に気が付きます。

 

【参考】
今回の記事の内容に関係した記事を2018年1月10日に掲載しました。「『わかりにくい案内図』から学ぶこと」というテーマの記事です。「自分が読み手だったらこの書き方でわかるか(内容が明確に伝わるか)」という視点で案内板を見れば、「この案内板はわかりにくい(内容が明確に伝わらない)」ということに気が付くはずです。

 

次回に続きます。

【参考文献】

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

 

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

 

   続きを読むには・・・


この記事の著者

森谷 仁

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

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


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

もっと見る
技術系ビジネスリーダーの養成 (その1)

【目次】 【技術系ビジネスリーダー養成 連載目次】 1、技術者の2つのキャリアパス 2、海外市場で事業成果を出せる技術系ビジ...

【目次】 【技術系ビジネスリーダー養成 連載目次】 1、技術者の2つのキャリアパス 2、海外市場で事業成果を出せる技術系ビジ...


現代でも通用する山本五十六メソッド

1. 理系新卒者の問題点  近年の大手企業の理系の新卒採用では、大学院修士卒の割合が多くなってきました。筆者の電気や自動車メーカーなどのクライ...

1. 理系新卒者の問題点  近年の大手企業の理系の新卒採用では、大学院修士卒の割合が多くなってきました。筆者の電気や自動車メーカーなどのクライ...


「業務内容の詳細」の書き方のポイント(技術士第二次試験対策を例に)

 今回の記事は、「わかりやすい文書の書き方」の考え方を参考にしながら「業務内容の詳細」の書き方のポイントを解説します。   技術士第二次試験...

 今回の記事は、「わかりやすい文書の書き方」の考え方を参考にしながら「業務内容の詳細」の書き方のポイントを解説します。   技術士第二次試験...


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

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

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

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


世界をリードするモノづくり中小企業の人づくり

 以前、東京国際フォーラムで東京理科大主催のパネルディスカッションが開催されました。テーマは「ニッチトップで世界をリードする日本のモノ作り企業」。株式会社...

 以前、東京国際フォーラムで東京理科大主催のパネルディスカッションが開催されました。テーマは「ニッチトップで世界をリードする日本のモノ作り企業」。株式会社...


【SDGs取組み事例】知識ゼロから出発。計400トンのCO<sub>2</sub>削減に成功 来ハトメ工業株式会社

2010(平成22)年にエコアクション21認証を取得し、ゼロの状態から脱炭素化に向けた取り組みを始めた来ハトメ工業株式会社(埼玉県八潮市)。電力使用量...

2010(平成22)年にエコアクション21認証を取得し、ゼロの状態から脱炭素化に向けた取り組みを始めた来ハトメ工業株式会社(埼玉県八潮市)。電力使用量...