マンガでわかる技術文書の書き方 「伝わる」から「明確に伝わる」へ

詳細目次

プロローグ
１章　内容が明確に伝わる技術文書を書く
２章　内容が明確に伝わる技術文書の書き方の３原則の概要
３章　書き方の第１原則　書き手と読み手の違いを認識する
４章　書き方の第２原則　内容が明確に伝わる構成を考える
　１：内容を項目に区分する
　２：技術文書の軸を決める
　３：軸となる項目を細分化する
　４：技術文書のストーリーを確認する
５章　書き方の第３原則　内容が明確に伝わる書き方を考える
　６つのルールと１８の書き方
【ルール１：冒頭に書く】
　＜書き方１：要点を冒頭に書く＞
　＜書き方２：全体像を冒頭に書く＞
　＜書き方３：枠組みを冒頭に書く＞
【ルール２：ペアで書く】
　＜書き方４：根拠を書く＞
　＜書き方５：条件を書く＞
【ルール３：分けて書く】
　＜書き方６：かたまりに分けて書く＞
　＜書き方７：箇条書きで書く＞
　＜書き方８：表で書く＞
【ルール４：視覚的に書く】
　＜書き方９：写真や図を入れて書く＞
　＜書き方10：強調して書く＞
　＜書き方11：まとまりを持たせて書く＞
【ルール５：合わせて書く】
　＜書き方12：組み合わせて書く＞
【ルール６：明確に伝わる文を書く】
　＜書き方13：具体的な文を書く＞
　＜書き方14：意味が明確な文を書く＞
　＜書き方15：能動態の文を書く＞
　＜書き方16：短い文を書く＞
　＜書き方17：肯定文を書く＞
　＜書き方18：文法を守って文を書く＞
　【コラム：18の書き方を組み合わせて使う】
６章　内容が明確に伝わる技術文書を書くうえで必要なこと
　伝える内容を明確に理解していること
　頭の中を整理すること
７章　日々のオンザジョブトレーニングを実践する
　日々のオンザジョブトレーニング
　＜１：基本のトレーニング＞
　＜２：会話を通したトレーニング＞
　＜３：概要版の作成を通したトレーニング＞
　＜４：自己添削を通したトレーニング＞
付録　実践での使い方
　1.Before:内容が明確に伝わらない技術文書
　2.After：内容が明確に伝わる技術文書
　3.修正の方法
　4.「６つのルールと18の書き方」との対応
参考文献
あとがき