説得できるドキュメンテーション200の鉄則 の商品レビュー

永山嘉昭(著者),山崎紅(著者),黒田聡(著者)

2010/12/22

勉強します。
例文とか載ってるのかなーと思ったら、決まり事をばしばし載せている感じ。
でもこの系統ははずれがありません。

2010/09/30

少々古い本。
買ってから読まずにほっておいたので改めて読み直しする。

文章の記述に関する定石は普遍だと思わせてくれる。買ったときだとあまり理解できなかったかもしれない。
ただ、5章から以降はあまり役に立たないような気がする。
以下は3章までの目次を整理したものだけど、タイトルだけでもなんとなく「重要」がわかる→普遍なのだろう。

表現技術
情報の理解
伝達効率
レイアウト・デザイン
視覚の特性
見易さの工夫
図解の利点
図解の基本
図解表現
図解要素
論理の図解方法
図解パターン
ロジックツリー
階層構造
フローチャート
表型マトリックス
マトリックス
マッピング
UMLとシステム構造

文章技術
読手を理解
論理的構成
文章の組み立て　概論から各論へ
文章の組み立て　各論は具体的に
文章の組み立て　段落は展開パターンを認識する
文章の組み立て　重要ポイントは最初に
文章の組み立て　意味のある並び順に
箇条書き
誤解を招かない文
　　　　簡潔な文
解りやすい文
具体的に
無駄な言葉を省く
整理して示す
見出し
専門用語・略語
社名・人名
用字・用語
記号
漢字と仮名
カタカナ表記