Maybe in this case it doesn't matter very much but there are a lot of ways comments can get lost or messed up.
Maybe in this case it doesn't matter very much but there are a lot of ways comments can get lost or messed up.
I've yet to be in a "oh this bit needs a comment" moments where the code couldn't be improved significantly to make it both better and more understandable.
I also had the "pleasure" to work in a few projects where it wasn't even on the list, beyond a few powerpoint presentations.
An example might help but to me bad code is code that repeats itself which includes comments. To me, comments should only be used for high level explanations (e.g. architecture, algorithms, public API) and when the purpose of code is non obvious (e.g. weird bug workarounds, optimisations). The vast majority of comments can be removed by rolling their contents into better function and variable names.