技術文書の品質管理(その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のチェックポイント

       

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

       

       

         続きを読むには・・・


      この記事の著者

      森谷 仁

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

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


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

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

        【この連載の前回:普通の組織をイノベーティブにする処方箋 (その134)へのリンク】   失敗の金銭的コストを低減する方...

        【この連載の前回:普通の組織をイノベーティブにする処方箋 (その134)へのリンク】   失敗の金銭的コストを低減する方...


      研究開発の生産性向上とは

         研究開発マネジメントの目的は、研究所の生産性を上げることです。研究開発の要である研究所のエンジニアリングについて、解説します。 &...

         研究開発マネジメントの目的は、研究所の生産性を上げることです。研究開発の要である研究所のエンジニアリングについて、解説します。 &...


      未来を経験・体験する 普通の組織をイノベーティブにする処方箋 (その56)

              現在イノベーションに必要な要素を表したKETICモデルの2つ目、Experience(経験)...

              現在イノベーションに必要な要素を表したKETICモデルの2つ目、Experience(経験)...


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

      もっと見る
      ハイヒール型プルタブオープナー  異分野市場での事業化事例 (その1)

      「部品技術の見える化」で、B2Bの部品からB2Cの完成品事業に成功したクライアントの事例を紹介します。A社は、金属加工の部品メーカーであり、田植え機、AT...

      「部品技術の見える化」で、B2Bの部品からB2Cの完成品事業に成功したクライアントの事例を紹介します。A社は、金属加工の部品メーカーであり、田植え機、AT...


      品質の仕組みとは2 プロジェクト管理の仕組み (その28)

       品質の仕組み、前回に続いて解説します。今回は、品質計画についてです。    計画の重要性は ISO9001でも「品質計画」として強調されて...

       品質の仕組み、前回に続いて解説します。今回は、品質計画についてです。    計画の重要性は ISO9001でも「品質計画」として強調されて...


      ‐産学交流からの開発テ-マと市場の観察‐  製品・技術開発力強化策の事例(その7)

       前回の事例その6に続いて解説します。産学交流による開発テ-マの探索や共同開発に関心が寄せられています。 大学には基礎研究の面で優れた開発テ-マの候補にな...

       前回の事例その6に続いて解説します。産学交流による開発テ-マの探索や共同開発に関心が寄せられています。 大学には基礎研究の面で優れた開発テ-マの候補にな...