[jti107]

i've found that well written code + useful comments + comment with link to design document works pretty well.

i got an email about code i'd written 10 years ago...thanking me for taking the time to document everything.