[latchkey]

document the why, not the what.

this is also why tests are so important. if you want to remove something, you have to think twice... once for the original code and once to fix the broken tests.

[regularfry]

That has saved me more times than I care to count. "Oh, that's why that code was there. I see."