技術者のためのテクニカルライティング入門講座


技術者のためのテクニカルライティング入門講座


翔泳社


著者:髙橋慈子


はじめに
目次

第1章 ロジカルライティング×テクニカルライティング活用の基礎知識
1.1 技術者の書く文章がわかりにくい3つの理由
1.2 そもそも「論理的」とはどのようなことか
1.3 思考を効果的にアウトプットするための「ロジカルライティング」
Column ロジカルシンキングの「フレーム」を使った情報の整理
1.4 「読み手」は目の前にいる人だけ?
1.5 「目的」ありき。読んだ人の行動を想定する
1.6 書き出す前にロジックを組み立てることが何より重要
1.7 情報をわかりやすく伝えるための「テクニカルライティング」
自己評価シート
第1章 確認テスト
第1章 確認テスト 解答と解説
Column 文章を書くのに時間がかかる人へのアドバイス
Column 「文、文章、文書」はどう違う?

第2章 わかりやすく、簡潔な文章を書くテクニック
2.1 一文一義で書く
2.2 文を長くしない。「~(だ)が」、「~ので」で文をつながない
2.3 一文を短く。50字以内で収めるように
Column 短い文にこそ、文章力が問われる
2.4 5W2Hを盛り込み、曖昧な文章にしない
2.5 メールの件名、文書のタイトルから目的が伝わるように書く
2.6 「話し言葉」と「書き言葉」を使い分ける
2.7 接続詞の使用は最小限に抑えて、効果的に使う
2.8 長くなりがちな文章を簡潔に仕上げるコツ
第2章 演習
第2章 演習 解答と解説
Column 冗長な文は、英語にしてもわかりにくい

第3章 読み手に伝わる文章を書くテクニック
3.1 最も重要な内容を先に書く
3.2 形容詞や名詞句でなく、動詞でズバリと書く
3.3 否定表現に気を付ける
3.4 受動態と能動態を使い分ける
3.5 具体的に情報を盛り込んで書く
3.6 「など」を多用しない
3.7 レビューを受けて、わかりやすさを高める
3.8 最後の文でしっかりと締めくくる
第3章 演習
第3章 演習 解答と解説
Column 「200字」トレーニングで文章力をアップする

第4章 読みやすさを高める文書フォーマット~表現・表記のルール~
4.1 文書に必須の要素を適切に書く
4.2 要素の配置と書式には意味がある
4.3 ブロック化して要素を区切る
4.4 カッコは2種類を基本として使う
4.5 フォントの使い分けのセオリーを知る
4.6 階層構造を数字や記号で示す
4.7 箇条書きを効果的に使う
4.8 カタカナ語と英字表記の基本的なルール
第4章 演習
第4章 演習 解答と解説

第5章 実践編 ユーザーマニュアル・取扱説明書
5.1 ユーザーマニュアル・取扱説明書の作成ポイント
5.2 企画・設計をする
5.3 ユースケースを想定する
Column 使いやすく、情報を探しやすい「ユーザーマニュアル」とは
5.4 作業(タスク)を整理して説明する
5.5 手順の書き方
5.6 概要の書き方
5.7 参考情報の書き方
Column 参考情報から価値を生み出す
5.8 注意文の書き方
第5章 実践トレーニング:ストップウォッチの「取扱説明書」の原稿を書いてみよう
第5章 実践トレーニングの作成例と解説

第6章 実践編 提案書
6.1 提案書の作成ポイント
6.2 情報を整理して、全体を設計する
6.3 スライド枚数の決め方
6.4 各スライドのポイントをタイトルで示す
6.5 箇条書きは7項目までにまとめる
6.6 表やグラフを活用する
6.7 図解や写真を使う
6.8 全体の流れを俯瞰して見直す
Column テーマのテンプレートに手を加えて、見やすくする
第6章 実践トレーニング:自社紹介のスライドを作ってみよう
第6章 実践トレーニングの作成例と解説
Column 説得力を高めるために「白書」を活用しよう

第7章 実践編 障害報告書
7.1 障害報告書の作成ポイント
7.2 障害報告書の読み手とロジックツリー
7.3 必須要素を適切に書き、社外文書の形式を整える
7.4 概要と事実を分けて整理する
7.5 事実、原因、対処の順に書く
7.6 原因をわかりやすく書く
7.7 再発防止策を示し、安心感を与える
7.8 リスクを減らすポイント
第7章 実践トレーニング:「障害報告書」を書いてみよう
第7章 実践トレーニングの作成例と解説
Column ものづくりに「言葉」を大切にする意識を

第8章 実践編 社外メール文
8.1 相手を納得させる社外メール文の作成ポイント
8.2 件名で用件を伝える工夫をする
8.3 重要な内容、相手にして欲しいことを最初に書く
8.4 トピックが一目でわかるように整理する
8.5 5W1Hまたは5W2Hを意識して書く
8.6 エモーショナルな表現を加える
8.7 日程や期限を明記する
8.8 署名を書いて行動につなげる
第8章 実践トレーニング:社外メール文を書いてみよう
第8章 実践トレーニングの作成例と解説

索引

書籍目次

Posted by shi-n