Linguistic Antipatterns(linguistic-antipatterns.com) |
Linguistic Antipatterns(linguistic-antipatterns.com) |
"Unexpected side effects" is one of my pet peeves (No magic!!!).
Its a sin on two counts, bad design and a "linguistic antipattern"
By choosing identifiers wisely combined with reducing cyclomatic complexity by describing actions with specific semantically-correct meanings, the amount of required comments and documentation to support a codebase properly can be reduced to essential familiarization material, defining of terms where needed, gotchas, and the explanation of specific engineering decisions and complex code.