Re:Avoid Indirection in Code
by ncmncm on Monday June 24, 2019 @04:46PM
(#20268295)
This is a really, really terrible way to name functions, or anything. I have seen code that tried to put the spec in the name, and it was awful.
A name that is long enough to tell you all you might need to know about what the thing named does is too long to be usable at all.
A name needs to be long enough to distinguish it from the other things being named. That's what naming means. If it also gives you a hint about which thing, of the things named, it really does, that makes it perfect.
Anything beyond that adds cognitive load, making it exponentially worse with each syllable added.
A name that is long enough to tell you all you might need to know about what the thing named does is too long to be usable at all.
A name needs to be long enough to distinguish it from the other things being named. That's what naming means. If it also gives you a hint about which thing, of the things named, it really does, that makes it perfect.
Anything beyond that adds cognitive load, making it exponentially worse with each syllable added.