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.