in reply to Terse or Self-Documenting Code

My rule is: if the code will live for more than 24 hours, it must be self-documenting. If another human is going to read the code, or myself in 24 hours after I've forgotten what I was doing, the code must be comprehensible. I've inherited too many pieces of code which might have been PGP signatures for all I could tell. I refuse to inflict that sort of suffering on others.