oosquare ML での議論の続き

といっても、中身は全然オブジェクト指向とは関係がなくなっている。
ドキュメントに何を書くべきか、という内容のスレッドの一部。

> why をどうやって書き残すのかのお知恵があれば
> お聞かせください。

という質問に対するワタシの意見。(回答になってないので意見)

why が書き残す必要がある情報なのかどうかどうやって判断しますか？スキルのある人にとって why は必然です(というか、why とすら思わない)。だから、書き残す必要性はないのです。
でも、スキルが無い人はなぜそうなのか分からない。
そのギャップを埋めるため、スキルがある人は懇切丁寧に、その人にとっては必然である why を、何倍もの労力と時間をかけて書き連ねる必要があるとでも言うのですか？
書いたところでバカはそんなところは読んでくれません。書いてなくても、できる人は聞いてくるし、自分で調べる。ワタシの経験はそれを(部分的に)証明しています。

なぜそういえるのか？それは12月6日の日記にヒントがある。興味ある方はご覧あれ。