How to Create Meaningful Names in Code

medium.com

17 pointskiyanwang2 comments

> A good rule of thumb is: If a name requires a comment, then it doesn’t reveal the intent.

This can actually be extended to whole functions as well. doProcessMessage() is terrible but sendMailIfNewAccount() is an improvement.

We have a rule that we don't write comments, instead we write log messages, and we try to write them after every branch corresponds with a business decision.

That's a very neat rule, and an interesting application of "code comments are bad and should not be used". Thanks for sharing!

Reply on news.ycombinator.com