I agree that these are all good things, but they cover the what and not the why. I find design documents useful to cover the why--something that results in a lo

I agree that these are all good things, but they cover the what and not the why. I find design documents useful to cover the why--something that results in a long comment in my experience is usually indicative of some non-trivial design decision.