Clean Code

FUNCTIONS SHOULD DO ONE THING. THEY SHOULD DO IT WELL. THEY SHOULD DO IT ONLY.

Functions should either do something or answer something, but not both.

The proper use of comments is to compensate for our failure to express ourself in code.

References

Clean Code: A Handbook of Agile Software Craftsmanship Code Smell: Martin Fowler Code Smell: Jeff Atwood Code Smell: Refactoring Code Smell: Wiki