4 ms·
> I hold an unpopular stance: code comments are as important as the code itself. It's unpopular because it is astonishingly wrong. Customer: "It does not work"
by pif 3y ago
> I hold an unpopular stance: code comments are as important as the code itself.
It's unpopular because it is astonishingly wrong. Customer: "It does not work". Me: "The comments are correct, the code is not, let's call it a 50/50".
> code comments are critical to code readability and maintainability
Fine, but we are on another level: once the code is right, maintainability becomes important. As long as the code is wrong, fix it and just pray that your code survives long enough for another soul to get a look at it!