Only Use Comments When They Are Really Useful
Topic | Source |
---|---|
๐งน Clean Code | Clean 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.