■内容が明確に伝わる技術文書を書くための4項目
以下の4項目を「理解・習得・実践」することで,内容が明確に伝わる技術文書を書くことができます。
①重要なことを理解する
②書き方の技術を習得する
③必要なことを理解する
④日々のオンザジョブトレーニングを実践する
◆重要なことを理解する
これは,内容が明確に伝わる技術文書を書くうえで重要なことを理解することです。重要なこととは,「技術文書を書く目的」や「“伝わる”と“明確に伝わる”の違い」などです。これらを理解することで,内容が明確に伝わる技術文書を書く必要性がわかります。
◆書き方の技術を習得する
これは,「内容が明確に伝わる技術文書の書き方の技術」を習得することです。書き方の技術とは,「内容が明確に伝わる技術文書の書き方の3原則」と「6つのルールと18の書き方」です。これらは,内容が明確に伝わる技術文書の書き方の中心となる内容です。
◆必要なことを理解する
これは,内容が明確に伝わる技術文書を書くうえで必要なことを理解することです。必要なこととは,「伝える内容を明確に理解していること」と「頭の中を整理すること」です。これらを理解することで,書き手が,伝える内容を理解しかつ整理できていることの重要性がわかります。
◆日々のオンザジョブトレーニングを実践する
これは,日々のオンザジョブトレーニング(継続学習)をすることです。日々のオンザジョブトレーニングの実践で,内容が明確に伝わる技術文書の書き方が習得できます。また,書き方の技術がレベルアップします。
「『君の書いた技術文書はわかりやすい』と言われる技術文書の書き方(その3)」から「 同 (その28)」では「②書き方の技術を習得する」について解説しました。
解説の順番は逆になりますが,次回から,「①重要なことを理解する」に関して解説します。
次回に続きます。
【参考文献】
森谷仁著,「マンガでわかる技術文書の書き方」,オーム社,令和4年3月25日