FWIW, here's how I think comments in source code can be improved, especially in exploratory programming: http://akkartik.name/codelog.html
Anyway please reparse my post with <sarcastic>...</sarcastic> around it.
-----
"There's nothing wrong with a code spec in this case" != "prose specs suck"