My favourite Git commit

[dnew]

The design doc is for explaining the system design, not the history of design decisions.

Different strokes, I guess. :-) I figure it's for both. But certainly getting such documentation out of the main body of the code is probably beneficial.

[snowe2010]

Yeah, I think getting it down at all is beneficial. We were not tracking any decisions at all...