Only Use Comments When They Are Really Useful

TopicSource
๐Ÿงน Clean CodeClean Code - Udemy

Overusing comments can make your code more difficult to read, even though they describe what's going on. Often, the information provided might be redundant and the additional text is slowing you down.

If you are using proper naming, the names should speak for themselves.
Use comments to give explanations, that can't be illustrated in code, e.g. for regular expressions.
They can also be helpful to warn other developers or give a special reason, why you did something a specific way.


  1. Clean code - write your code like an author writes a story