技術文書の品質管理(その2)技術文書を確認する人の視点から

投稿日

技術文書の品質管理(その2)技術文書を確認する人の視点から 
【目次】

    今回は、自分以外の人が技術文書の品質管理をする場合(自分が書いた技術文書を自分以外の人が確認する)に関する解説です。前回と異なり、自分以外の人の視点つまり技術文書を確認する人の視点で解説します。具体的な例として、部下が書いた技術文書を確認するとき(チェックするとき)を考えます。

     

    1.「部下が書いた技術文書をチェックするときに必要なこと」とは

    部下が書いた技術文書をチェックするときに必要なこととは「内容が明確に伝わらない書き方(わかりにくい書き方)の基準を持っていること」と「その具体的な修正方法の指示ができること」です。

     

    「〇〇君の書いたこの打ち合わせ資料は内容が明確に伝わらない(わかりにくい)ので修正してくれ」のような指示を部下が受けたとします。

     

    このように指示されれば「どこがわかりにくいのだろう?」と考え、部下は打ち合わせ資料を読み返す必要があります。この打ち合わせ資料を書いた部下は“書き手”なので“知っている人”です注1)。書き手の立場(知っている人の立場)で書いているので内容が明確に伝わらない箇所がすぐにわからないかもしれません。あるいは、内容が明確に伝わらない箇所を見つけることができないかもしれません。

     

    2. 具体的な修正方法の指示を出す

    上司が、内容が明確に伝わらない書き方の基準を持ちさらにその修正方法がわかれば、上司は、部下に対して具体的な修正方法の指示ができます。具体的な修正方法の指示を出すことで、部下も「内容が明確に伝わらない」の意味を理解したうえで自分が書いた技術文書を修正することができます。例えば、以下のような指示です。

     

    • ①結論がわかりにくいので結論を打ち合わせ資料の冒頭に書いたほうがよい。
      *「6つのルールと18の書き方注2)」の中の「書き方1:要点を冒頭に書く」に対応します。
    • ②決定事項に対して明確な根拠が書いてないので決定事項が明確に伝わる根拠を書いたほうがよい。
      *「6つのルールと18の書き方」の中の「書き方4:根拠を書く」に対応します。
    • ③この箇所は文の羅列で書いてあるので見出しを付けてかたまりに分けて書いたほうがよい。
      *「6つのルールと18の書き方」の中の「書き方6:かたまりに分けて書く」に対応します。
    • ④この文は長いため内容がわかりにくいので一文一義の考え方で書いたほうがよい。
      *「6つのルールと18の書き方」の中の「書き方16:短い文を書く」に対応します。

    技術文書の品質管理(その2)技術文書を確認する人の視点から

     

    このような具体的な修正方法を指示してもらえれば部下も修正がすぐにできます。また、内容が明確に伝わらない書き方とその修正方法も学べます。

     

    部下に具体的な修正方法の指示を出すためにも「内容が明確に伝わらない書き方(わかりにくい書き方)の基準を持つこと」と「内容が明確に伝わらない書き方の修正方法がわかること」が上司にも必要です注3)

    技術文書の品質管理(その2)技術文書を確認する人の視点から 
    【目次】

      今回は、自分以外の人が技術文書の品質管理をする場合(自分が書いた技術文書を自分以外の人が確認する)に関する解説です。前回と異なり、自分以外の人の視点つまり技術文書を確認する人の視点で解説します。具体的な例として、部下が書いた技術文書を確認するとき(チェックするとき)を考えます。

       

      1.「部下が書いた技術文書をチェックするときに必要なこと」とは

      部下が書いた技術文書をチェックするときに必要なこととは「内容が明確に伝わらない書き方(わかりにくい書き方)の基準を持っていること」と「その具体的な修正方法の指示ができること」です。

       

      「〇〇君の書いたこの打ち合わせ資料は内容が明確に伝わらない(わかりにくい)ので修正してくれ」のような指示を部下が受けたとします。

       

      このように指示されれば「どこがわかりにくいのだろう?」と考え、部下は打ち合わせ資料を読み返す必要があります。この打ち合わせ資料を書いた部下は“書き手”なので“知っている人”です注1)。書き手の立場(知っている人の立場)で書いているので内容が明確に伝わらない箇所がすぐにわからないかもしれません。あるいは、内容が明確に伝わらない箇所を見つけることができないかもしれません。

       

      2. 具体的な修正方法の指示を出す

      上司が、内容が明確に伝わらない書き方の基準を持ちさらにその修正方法がわかれば、上司は、部下に対して具体的な修正方法の指示ができます。具体的な修正方法の指示を出すことで、部下も「内容が明確に伝わらない」の意味を理解したうえで自分が書いた技術文書を修正することができます。例えば、以下のような指示です。

       

      • ①結論がわかりにくいので結論を打ち合わせ資料の冒頭に書いたほうがよい。
        *「6つのルールと18の書き方注2)」の中の「書き方1:要点を冒頭に書く」に対応します。
      • ②決定事項に対して明確な根拠が書いてないので決定事項が明確に伝わる根拠を書いたほうがよい。
        *「6つのルールと18の書き方」の中の「書き方4:根拠を書く」に対応します。
      • ③この箇所は文の羅列で書いてあるので見出しを付けてかたまりに分けて書いたほうがよい。
        *「6つのルールと18の書き方」の中の「書き方6:かたまりに分けて書く」に対応します。
      • ④この文は長いため内容がわかりにくいので一文一義の考え方で書いたほうがよい。
        *「6つのルールと18の書き方」の中の「書き方16:短い文を書く」に対応します。

      技術文書の品質管理(その2)技術文書を確認する人の視点から

       

      このような具体的な修正方法を指示してもらえれば部下も修正がすぐにできます。また、内容が明確に伝わらない書き方とその修正方法も学べます。

       

      部下に具体的な修正方法の指示を出すためにも「内容が明確に伝わらない書き方(わかりにくい書き方)の基準を持つこと」と「内容が明確に伝わらない書き方の修正方法がわかること」が上司にも必要です注3)

       

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

      ◆関連解説記事:実践!技術マネジメント:7つのプロセスと35のチェックポイント

       

      特集】技術士第二次試験対策:技術士第二次試験に関する記事まとめページはこちら!口頭試験や論文対策などのポイントについての記事を紹介しています。

       

       

         続きを読むには・・・


      この記事の著者

      森谷 仁

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

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


      「技術マネジメント総合」の他のキーワード解説記事

      もっと見る
      イノベーションの創出 普通の組織をイノベーティブにする処方箋 (その132)

        【この連載の前回:普通の組織をイノベーティブにする処方箋 (その131)へのリンク】 現在「切り取った知識の重要部分を発想するフレー...

        【この連載の前回:普通の組織をイノベーティブにする処方箋 (その131)へのリンク】 現在「切り取った知識の重要部分を発想するフレー...


      未来志向でコア技術を設定する 普通の組織をイノベーティブにする処方箋 (その28)

       そろそろ自社の技術ではなく、社外の技術の収集の議論に移りたいのですが、私のところで起こったある出来事で、『未来志向でコア技術を設定する』ことを強調してお...

       そろそろ自社の技術ではなく、社外の技術の収集の議論に移りたいのですが、私のところで起こったある出来事で、『未来志向でコア技術を設定する』ことを強調してお...


      リーン製品開発の全体像 – 統合プロダクトチーム

         前回の「リーン製品開発※の全体像 – イベント駆動型のプロセス」に続けて解説します。   ◆ 統合プロダクトチ...

         前回の「リーン製品開発※の全体像 – イベント駆動型のプロセス」に続けて解説します。   ◆ 統合プロダクトチ...


      「技術マネジメント総合」の活用事例

      もっと見る
      新事業開発のステップを事例で考える

       中小ものづくり企業が自前のヒット商品を開発し、販売まで行うのは容易なことではありません。しかし、だからと言って下請け仕事を続けていて、利益を上げることは...

       中小ものづくり企業が自前のヒット商品を開発し、販売まで行うのは容易なことではありません。しかし、だからと言って下請け仕事を続けていて、利益を上げることは...


      設計部門の課題と原因分析(その3)

      【設計部門の課題と原因分析 連載目次】 1. 設計部門の現状を正確に特定する 2. 課題分析と課題の根本原因除去 3. 設計部門用に用意したコン...

      【設計部門の課題と原因分析 連載目次】 1. 設計部門の現状を正確に特定する 2. 課題分析と課題の根本原因除去 3. 設計部門用に用意したコン...


      材料研究、最適化のワナと温故知新の事例

        1.  材料研究と最適化  材料研究の場合、「最適化」という言葉でモノを考えない方がいいでしょう。  若い人、時にはおじ...

        1.  材料研究と最適化  材料研究の場合、「最適化」という言葉でモノを考えない方がいいでしょう。  若い人、時にはおじ...