2013年12月18日のブックマーク (2件)

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

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

    aabbccD
    aabbccD 2013/12/18
  • 練習と稽古 - Freezing Point

    先日のエントリのことでお話をご一緒していたら、 精神科医・美術批評家の三脇康生氏より 試合より、練習のほうが重要 というアイデアを頂いて、そこからずっと考えています。 練習というのは、非常にふしぎな概念です。 たんなる精神でも、たんなる身体でもない。 概念はふつう、一挙に丸ごと手に入るものですが、練習というのは、時間的なことを設計しなおさなければならない。概念そのものに、素材と時間要因が同時に含まれています。*1 イタリア精神保健のイベントで感じたことでいうと、 いくら素晴らしい議論を誰かがしても、それを受け止める準備ができていなければ、なんだか綺麗ごとの理念で終わってしまいます。だとすると、重要な議論をそれとして持続できるようになるためには、それに応じた、集団的な《練習》が必要にもなるでしょう。 ――長い時間をかけて、いろんな方とご一緒したいような、議論のふくらみを感じています。三脇氏が

    練習と稽古 - Freezing Point
    aabbccD
    aabbccD 2013/12/18