Sign in

Importance of Cleaning Code III — The Art of Commenting

The more I delve into Uncle Bob’s Clean Code and listen to his lectures I realize that a lot of simple concepts have been misunderstood and misused — to be more blunt, a little bit abused. Comments fall under this category. By definition, they are supposed to describe what the code does and supplement it. But the truth, as Bob describes them, they are a necessary evil. Most likely they become absolutely necessary when a programmer is in rush and does a quick fix but he knows this is not a permanent solution and needs to be cleaned up later. He leaves a comment…