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

投稿日

技術文書

 

 

今回から、「6つのルールと18の書き方」に関する補足解説をします。今回は、「ルール1:冒頭に書く」の中の「書き方1:要点を冒頭に書く」に関する補足解説です。「書き方1:要点を冒頭に書く」と「ネットでの検索とその検索結果」の関係です。

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

人財教育

1.「〇〇とは」と検索する

何かを調べるときネットを使う方も多いと思います。そのとき「〇〇とは」と入力し検索する方もいると思います。例えば、2023年10月1日から導入される「インボイス制度」について調べたいとき「インボイス制度とは」と打ち込み検索することです。実際に「インボイス制度とは」と打ち込んで検索してみると、あるウェブサイトでは次のような説明が書いてあります。

 

インボイス制度とは、軽減税率により複数の税率ができたとき、仕入れ税額控除に適格請求書(インボイス)などの保存が要件となる制度です。』

 

このウェブサイトでは、「インボイス制度とは」という検索に対して、ウェブサイトの冒頭で、「インボイス制度とは・・・です」のように検索結果を簡潔に説明しています。つまり、ウェブサイトの冒頭で、インボイス制度の要点を簡潔に説明しています。また、「インボイス制度とは・・・です」という説明の後にインボイス制度について詳しく説明しています。

 

このウェブサイトは、「インボイス制度とは」という質問に対して内容が明確に伝わる解説をしています。

 

これは、「書き方1:要点を冒頭に書く」の書き方です。「書き方1:要点を冒頭に書く」とは、「内容に関する要点を冒頭に書き、この要点に関する説明をその後に書くこと」だからです。また、これは、「内容が明確に伝わる技術文書の書き方(その12)」で書いた以下の書き方と同じです。

 

【パターンⅡ】

1.〇〇交差点の改良計画の目的

〇〇交差点をスクランブル交差点に改良することが今回の〇〇交差点の改良計画の目的である。〇〇交差点では、歩行者や自転車と左折車との接触事故が毎年数件発生している。過去には歩行者の死亡事故も発生している。来年3月末には、〇〇交差点付近に大型ショッピングセンターができることから、〇〇交差点を利用する歩行者や自転車が増えると予想できる。そのため、歩行者や自転車の安全確保のため〇...

技術文書

 

 

今回から、「6つのルールと18の書き方」に関する補足解説をします。今回は、「ルール1:冒頭に書く」の中の「書き方1:要点を冒頭に書く」に関する補足解説です。「書き方1:要点を冒頭に書く」と「ネットでの検索とその検索結果」の関係です。

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

人財教育

1.「〇〇とは」と検索する

何かを調べるときネットを使う方も多いと思います。そのとき「〇〇とは」と入力し検索する方もいると思います。例えば、2023年10月1日から導入される「インボイス制度」について調べたいとき「インボイス制度とは」と打ち込み検索することです。実際に「インボイス制度とは」と打ち込んで検索してみると、あるウェブサイトでは次のような説明が書いてあります。

 

インボイス制度とは、軽減税率により複数の税率ができたとき、仕入れ税額控除に適格請求書(インボイス)などの保存が要件となる制度です。』

 

このウェブサイトでは、「インボイス制度とは」という検索に対して、ウェブサイトの冒頭で、「インボイス制度とは・・・です」のように検索結果を簡潔に説明しています。つまり、ウェブサイトの冒頭で、インボイス制度の要点を簡潔に説明しています。また、「インボイス制度とは・・・です」という説明の後にインボイス制度について詳しく説明しています。

 

このウェブサイトは、「インボイス制度とは」という質問に対して内容が明確に伝わる解説をしています。

 

これは、「書き方1:要点を冒頭に書く」の書き方です。「書き方1:要点を冒頭に書く」とは、「内容に関する要点を冒頭に書き、この要点に関する説明をその後に書くこと」だからです。また、これは、「内容が明確に伝わる技術文書の書き方(その12)」で書いた以下の書き方と同じです。

 

【パターンⅡ】

1.〇〇交差点の改良計画の目的

〇〇交差点をスクランブル交差点に改良することが今回の〇〇交差点の改良計画の目的である。〇〇交差点では、歩行者や自転車と左折車との接触事故が毎年数件発生している。過去には歩行者の死亡事故も発生している。来年3月末には、〇〇交差点付近に大型ショッピングセンターができることから、〇〇交差点を利用する歩行者や自転車が増えると予想できる。そのため、歩行者や自転車の安全確保のため〇〇交差点を改良する。

 

ネットでの検索とその検索結果を読めば、「書き方1:要点を冒頭に書く」を使って技術文書を書くことで内容が明確に伝わることがわかります。

 

次回に続きます。

 

【参考文献】

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

 

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

 

   続きを読むには・・・


この記事の著者

森谷 仁

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

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


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

もっと見る
ブレインストーミングで豊かな発想を生み出すテクニック

  「他に何かアイデアはないの?」と言われても、何も思い浮かばなかったり、他の人が考える様なコトばかりが頭に浮んでしまい、焦るコトってあり...

  「他に何かアイデアはないの?」と言われても、何も思い浮かばなかったり、他の人が考える様なコトばかりが頭に浮んでしまい、焦るコトってあり...


革新的テーマを継続的に創出するための表彰をより良く機能させるためのポイント

 革新的テーマを創出するための環境には「ハードの仕組み」に加え、心理的な「ソフトの仕組み」が必要の訳ですが、今回はこの中から、表彰に焦点を当て議論をしたい...

 革新的テーマを創出するための環境には「ハードの仕組み」に加え、心理的な「ソフトの仕組み」が必要の訳ですが、今回はこの中から、表彰に焦点を当て議論をしたい...


若手・中堅社員の実践的教育とは

 若手・中堅社員の実践的教育は、中小製造業の共通の課題です。限られた人材で、多品種少量受注生産を強いられる工場では、品質・納期をどのように確保するのかが最...

 若手・中堅社員の実践的教育は、中小製造業の共通の課題です。限られた人材で、多品種少量受注生産を強いられる工場では、品質・納期をどのように確保するのかが最...


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

もっと見る
人財教育・人材育成、こだわりと責任範囲

【目次】 ▼さらに深く学ぶなら!「ビジネススキル」に関するセミナーはこちら! 1. こだわり「別の方法がある」と考えることも大事 ...

【目次】 ▼さらに深く学ぶなら!「ビジネススキル」に関するセミナーはこちら! 1. こだわり「別の方法がある」と考えることも大事 ...


コンプライアンス意識を持とう:職場のマネジメント

  ◆ 物流監督者の心掛け  今回は、物流監督者が職場をマネジメントする際に取るべき態度や行動についてお話します。なぜなら、その態度や行...

  ◆ 物流監督者の心掛け  今回は、物流監督者が職場をマネジメントする際に取るべき態度や行動についてお話します。なぜなら、その態度や行...


人財教育・人材育成、 理由のないルール、あなたの感情を他人はわからない

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

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