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