H2O Blog. • 分かりやすい文章を書くために工夫していること

Editors’ & Writers’ Advent Calendar 2013 - Adventar の18日目です。 私は、『WordPressをちゃんと使うための教科書』や『よくわかるPHPの教科書』、『よくわかるJavaScriptの教科書』など、初心者さん向けの入門書などを執筆しています。 今日はそんな入門書を書いた経験から、「分かりやすい文章を書くために工夫していること」をいくつか紹介してみたいと思います。 解説をとばす 技術系の記事の場合、どうしても「例外」があったり、ケースによって必要なことが異なることがあります。これらを一文の中で説明しようとすると、どんどん結論が先延ばしされて、全体的に難解な文章になっていってしまいます。 そこで、文章ではそのような例外などをどんどんとばして簡潔に説明し、代わりにコラムなどを使って、一つずつ紹介をします。 例） 6-23の手順に従って、デ

[gin-oi2]

初心者や専門的知識のない人に説明するような文書を書く時に注意したい

[efcl]

初心者向けの文章(書籍)を書くときのTips