2 ms·
How to Create Meaningful Names in Code
- exabrial 7y ago> 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.
- KlaymenDK 7y agoThat's a very neat rule, and an interesting application of "code comments are bad and should not be used". Thanks for sharing!