If it's not legible it's better to rewrite it to be legible rather than adding more comments.
Sometimes this is not possible because the code is inherently complex but most of the time it is IMO.
Personally I don't have a problem with coming back to my sparsely commented code because unless I'm in a hurry I structure it properly so it's fairly easy to read. Usually it boils down to keeping your functions/methods small and doing proper separation of concern.
The same argument works for other people's code too. If it's not garbage it probably won't need a whole lot of comments.
Also during my years of professional experience I've decided to just bite the bullet and learn to read other people's code quickly. You're just not gonna get the required amounts of discipline to have nice clean documented code from your average developer because most of them (somewhat understandably) don't really give a shit about it, might as well just roll with it and try to not make it worse with your own code.
It gets easier after the 10th legacy shitpile you're forced to maintain.
If it's not legible it's better to rewrite it to be legible rather than adding more comments.
Sometimes this is not possible because the code is inherently complex but most of the time it is IMO.
Personally I don't have a problem with coming back to my sparsely commented code because unless I'm in a hurry I structure it properly so it's fairly easy to read. Usually it boils down to keeping your functions/methods small and doing proper separation of concern.
deleted by creator
The same argument works for other people's code too. If it's not garbage it probably won't need a whole lot of comments.
Also during my years of professional experience I've decided to just bite the bullet and learn to read other people's code quickly. You're just not gonna get the required amounts of discipline to have nice clean documented code from your average developer because most of them (somewhat understandably) don't really give a shit about it, might as well just roll with it and try to not make it worse with your own code.
It gets easier after the 10th legacy shitpile you're forced to maintain.
deleted by creator
I'm just offering my experiences, no need to get pissy.
deleted by creator
Didn't even notice it was deleted.
If you expected unanimous agreement on things like this you're in the wrong line of work.
deleted by creator