>Code is the what. Comments are the why. In general I'd prefer to see 'why' attached to behavioral tests. When I am asking "why was it written this way?" 8 ti

>Code is the what. Comments are the why. In general I'd prefer to see 'why' attached to behavioral tests. When I am asking "why was it written this way?" 8 times out of 10 it's the actual desired behavior that I don't get, maybe 2 time out of 10 it's "why was it implemented this way" (and most of the time those are apologizing for hacks).