Avoid too abstract names. Names should have real world meaning

Problems

• Implemental Naming

• Meaningless names

• Broken MAPPER and Bijection to real world entities.

Solutions

1. Choose meaningful names.

2. Find metaphors.

3. Avoid words like abstract, base, generic, helper etc.

4. Use rules for naming.

Sample Code

Wrong

Right

Detection

We can set up policies and rules warning for certain words like base, abstract, helper, manager, object etc.

Tags

• Naming

Conclusion

Finding names is the last thing we should do on our designs. Unless we have a clear business understanding, good names emerge at the end after defined behavior and protocol boundaries.

Relations

Code Smell 22 - Helpers

Maxi Contieri ・ Nov 12 '20

#oop #helpers #codenewbie #beginners

Code Smell 25 - Pattern Abusers

Maxi Contieri ・ Nov 15 '20

#oop #tutorial #programming #patterns

More info

what is in a name

Credits

Photo by Rodion Kutsaev on Unsplash

There are only two hard things in Computer Science: cache invalidation and naming things.

Phil Karlton