Why comments in the code are not always good!
(1) Because they are not updated.
When ever the code is changed, the comments should also be changed. But it may happen like the code is updated but not the comments which may confuse the next developer.
(2) Maintenance problem.
Highly commented code is difficult to maintain. Think of a situation where change in a line of code requires you to edit five lines of comment.
(3) They add up to the size of the file.
This is a matter of great significance if your file goes across the network. For example:
Heavily commented JavaScript file may take time to get downloaded to the client machine. This is may affect the Performance of web app.
(4) Irritating.
Think of a comment.
total = mine + your; // adding mine and your cash to calculate the total cash.
If you read a line such as this don’t you feel irritated? Most of the times in line comments are useless.
(5) Using comments as the solution for bad coding style.
The method names and variable names should self explainable. It shouldn’t happen like you are writing comments to make up for the in appropriate names you have used. Probably here you need to change the coding style than Adding more comments.
Anything else you can think of ?
Congrats to Infy aka Infosys on reaching magic number 100000. Now we are a family of one lakh members across the world. 19675 makes me feel so old :)
