3 ms·
> Good comments adds to readability I agree. I was talking about the _amount_ of comments. Extreme example: void foobar() { // iterate over the list
by kyberias 10y ago
> Good comments adds to readability
I agree. I was talking about the _amount_ of comments.
Extreme example:
void foobar()
{
// iterate over the list
foreach(var item in list)
{
// send it
sender.send(item);
}
}
I've seen a lot of comments like this. They don't add value. They distract. They must be removed.
They also tell that the author didn't have a clear understanding why code comments should be written, so we may not trust his/her judgement in other programming decisions. The code is suspect. It's a code smell.
- lisivka 10y agoIt's looks like top-to-bottom style of development: first, algorithm is written in text, then implemented in code. Kind of literate programming. Sometimes it helps, sometimes it not. Usually, this style is used right after the school, by inexperienced programmers incapable to keep algorithm in the head in parallel to development, or when experienced developer does his first steps in a new language. Not a problem for me. Usually, I clear them out.