推敲の技術 - 開発者の技術文書作成法

• 推敲（推敲）: 文章を書く際に何度も考えて直し、磨き上げること。あるいはその作業

• 推敲が必要な理由

• 推敲のTips

→ 自分の文章を見慣れないものにする: 声に出して読む、少し時間を置いてから読む、紙に印刷して読む

→ ピアレビュー

→ チェックリストの活用

→ 可読性を高める文章修正のTip

① 短文に整理して修正する

② 不要な表現を削除する

③ 論理的な文章へと作り変える

[budlebee]

スティーヴン・キングの文章術の原則を思い出します。小説なのでテクニカルライティングとは異なる点もあるでしょうが、思いつくままに書いてみると

• 短く簡潔な文を使う。

• 私は初稿を書いたあと、その初稿を引き出しにしまっておき、6か月後に取り出して読み返す。

• 推敲版では初稿から10%削る。

• 声に出して読んでみると、文のぎこちない部分を見つけられる。

• 文章を読む相手を具体的に決めてから書く。私の場合は妻だ。

[xguru]

最近はカカオエンタープライズのテクニカルライティング担当の方々が良い記事をたくさん書いてくれていますね。ブログの購読をおすすめします！