物事を説明するときは、歴史的説明をするのがよい

finalvent @finalvent

説明文の書き方というのは、慣れた人には教えるのは比較的容易いんだけど、現実では意外と難しい。理由は、書く人が知識をもって指示的に書けば済むように見えるけど、実際は、対象の文脈に置かれた読者がどのように指示を意識するか、そのコアの直感を了解させないとロボットのプログラムになる。

finalvent @finalvent

その直感提示に有効なのが、比喩と例なんだけど、これがまた別の問題を起こす。

finalvent @finalvent

オブジェクト指向プログラミングのオブジェクトを比喩で説明すると、必ずと言っていいほど失敗する。

finalvent @finalvent

説明文を書くときは、なぜその説明が読者に必要となるのか、実は、その読者と書き手の関係における書き手の責務意識が重要になる。でも、説明文の書き手はしばしば、書く技術論でそこを逃げてしまう。

finalvent @finalvent

「説明文の書き方」みたいにをいくら学んでも、それを読んだ読者のリアクションの現場を知らないと、実際にはあまり意味ない。

finalvent @finalvent

物事を説明するときは、(1)原理的説明、(2)教育的説明、(3)歴史的説明の三つの面があり、どれが優れてるわけでもないが、重要なのは、(3)の歴史的説明。書き手は対象がこの世界に現れた過程を理解するといい。(1)原理的な説明はいかにも正しいように見えるが、説明には向かない。

finalvent @finalvent

プログラミングで、「変数」みたいなレベルで理解できない人がいるが、これはある意味当然なことで、数学上の変数とも違う。

finalvent @finalvent

なぜ変数を使うのか？ というのは、自明すぎる人には説明できないし、そこに潜む問題も理解できない。ちなみに、初等数学におけるxとかは、既知値として等式を成立させるためにある。代入とかできない。