netail.net

_ お菓子 ▲

来客からお菓子をもらった．

明月庵という和菓子屋さんで，鮎菓子とクリーム大福．鮎菓子は普通．クリーム大福は，大福の中身がカスタードクリームになっているもの．味は雪見大福（バニラ）に近い印象がある．

_ 紅茶 ▲

さくらティー(45g)を全部飲みきった．そろそろ次の補充に行きたいのだが，ダージリンのファーストフラッシュを買ってしまうかセカンドフラッシュを待つか悩みどころ．両方飲んだほうが楽しいといえば楽しいのだが．

_ [お出かけ] 三宮 ▲

mahisaというお店で，きのこのソテーとチーズを載せて焼いたマフィンがとてもおいしかった．ケーキとか甘いものメインの喫茶店なのだけど，これは軽い食事としてよさそう．

_ [論文] 開発者はドキュメントは読んでない ▲

LaToza, T. D., Venolia, G. and DeLine, R.: Maintaining Mental Models: A Study of Developer Work Habits. Proceedings of the 28th International Conference on Software Engineering (ICSE 2006), pp.492-501, Shanghai, China, May 2006. [ACM site]

開発者の作業時間の割合を調査した論文で，納期が近づくにつれて新機能を書く時間よりバグフィクスにかかる時間のほうが増えているとか，作業に割り込みがかかると，元の作業に復帰するまでには時間がかかるといった知見を得ています．

プログラム理解に使っている時間とコードを書いてる時間には負の相関があり，開発者は，自分が書いたコードについては十分な知識を持っているからプログラム理解には時間を消費してはいないようだとしています．

設計ドキュメントはいちおう書くものの，書いたものを読み返すことはまれであり，実際には自分が相手にしているコードを読んで知識を再発見している（そしてドキュメントは陳腐化していく）としています．

D. Spinellis の Code Quality (Addison-Wesley)の 7.2 Analyzability でも「コメントはアップデートするべきだが，他人がそうしてることを期待してはいけない」と言及されていたりするのですが，ドキュメントをきちんと更新しないから読まないのか，読まれないからどうせ更新しないのか，因果関係は謎です．ただ，こういうのを読んでると，「ソースがドキュメントだ」という発言にはそれなりに説得力がある気がしてきます．