...
内容が明確に伝わる技術文書の書き方（その21）
投稿日 2022-11-15
「６つのルールと18の書き方」に関し「６つのルール」および「18の書き方」の概要について解説してきました。「６つのルールと18の書き方」を以下に示します。今回は「６つのルールと18の書き方」を「わかりにくい」に対する判断基準にするを解説します。
【この連載の前回：内容が明確に伝わる技術文書の書き方（その２０）へのリンク】
１．「６つのルールと18の書き方」を判断基準にする
「内容が明確に伝わる技術文書の書き方（その20）」の記事の中で以下のことを書きました。
「この書き方はわかりにくい（内容が明確に伝わらない）」と気が付くためには、「どのような書き方をしたらわかりにくいか」という「わかりにくい」に対する判断基準が必要です。
これまで、「６つのルールと18の書き方」について解説しました。この「６つのルールと18の書き方」が「わかりにくい」に対する判断基準になります。
「６つのルールと18の書き方」を使って書けば内容が明確に伝わる技術文書（わかりやすい技術文書）を書くことができます。逆に言うと、「６つのルールと18の書き方」に反した書き方で書けば内容が明確に伝わらない（わかりにくい）技術文書になります。つまり、「６つのルールと18の書き方」が「わかりにくい」に対する判断基準になります。例えば、以下のようなことです。
- 内容の要点を冒頭に書いてないのでわかりにくい。⇒「書き方1：要点を冒頭に書く」に反している。
- 文の羅列で書いてあるのでわかりにくい。 ⇒「書き方6：かたまりに分けて書く」に反している。
- 写真がないのでわかりにくい ⇒「書き方9：写真や図を入れて書く」に反している。
- 具体的な文を書いてないのでわかりにくい。 ⇒「書き方13：具体的な文を書く」に反している。
また、「６つのルールと18の書き方」を使って、「わかりにくい（内容が明確に伝わらない）書き方」を「わかりやすい（内容が明確に伝わる）書き方」に修正することができます。例えば、以下のようことです。
- 内容の要点が文章の最後に書いてあるのでわかりにくい。⇒「書き方1：要点を冒頭に書く」を使って修正しよう。
- この箇所は文の羅列で書いてあるのでわかりにくい。 ⇒「書き方6：かたまりに分けて書く」を使って修正しよう。
- 「○○駅では、４月から△△線と□□線との乗り換えが同一ホームでできるようになった。その結果、鉄道利用者の利便性が向上した」と書いてあるのでわかりにくい。⇒「書き方13：具体的な文を書く」を使って修正しよう。
このように、「６つのルールと18の書き方」は、「わかりにくい」に対する判断基準になります。また、「わかりにくい」を「わかりやすい」に修正する方法として使えます。
次回に続きます。
【参考文献】
森谷仁著、「マンガでわかる技術文書の書き方」、オーム社、令和4年3月25日
続きを読むには・・・
「人財教育・育成」の他のキーワード解説記事
もっと見る
研究開発に威力を発揮するモチベーション理論
1．モチベ―ションをどう捉えるか かつて、バブルの全盛期に、新卒を採用するためにいろいろな特典を用意していたことを覚えているでしょうか。車を買ってあげ...
1．モチベ―ションをどう捉えるか かつて、バブルの全盛期に、新卒を採用するためにいろいろな特典を用意していたことを覚えているでしょうか。車を買ってあげ...
内容が明確に伝わる技術文書の書き方（その１）
【この連載の前回：“技術文書を書くこと”について考える（その４）へのリンク】 今回から、「内容が...
【この連載の前回：“技術文書を書くこと”について考える（その４）へのリンク】 今回から、「内容が...
緊張をほぐして、説明力と説得力を高められる簡単な方法とは
人前で何かを説明したり説得をするシーンは、ビジネスパーソンにとっては日常茶飯事です。しかし、大なり小なりその前には「緊張」が伴うのでは...
人前で何かを説明したり説得をするシーンは、ビジネスパーソンにとっては日常茶飯事です。しかし、大なり小なりその前には「緊張」が伴うのでは...
「人財教育・育成」の活用事例
もっと見る
【SDGs取組み事例】SDGs理念の下、企業と住民が地域課題解決に向け連携
♦「真善美」の考えが人を育む 太陽工業株式会社（長野県諏訪市） 目次・SDGs対応が取り引きや会社選びの基準に・資格認定制度を設け社内...
♦「真善美」の考えが人を育む 太陽工業株式会社（長野県諏訪市） 目次・SDGs対応が取り引きや会社選びの基準に・資格認定制度を設け社内...
【SDGs取り組み事例】自然と社会との共生を目指して 日本テクノ株式会社
従業員主体で環境保護、サステナビリティへの取り組み 日本テクノ株式会社（東京都新宿区） SDGs（持続可能な開発目標）の観点からみても重要な取り組...
従業員主体で環境保護、サステナビリティへの取り組み 日本テクノ株式会社（東京都新宿区） SDGs（持続可能な開発目標）の観点からみても重要な取り組...
やろうと思っているけどできないことばかり、の克服（その5）
前回は、やる気を起こすにはとにかく行動することが大切で、行動を起こすための工夫をいくつか紹介しました。やろうと思ってできなかったことも、これで取りかかる...
前回は、やる気を起こすにはとにかく行動することが大切で、行動を起こすための工夫をいくつか紹介しました。やろうと思ってできなかったことも、これで取りかかる...
