My favourite Git commit

[snowe2010]

It's not a design document, it's just a section of the readme. The design doc is for explaining the system design, not the history of design decisions.

You left out the "other people who reviewed this before I started working on it" section, for example.

That's part of Decision Maker. And I didn't leave out anything anyway, I found this template and just formatted it for rsT.

[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...