Do all the things like ++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatarSign Up
🤔 after the kind of nonsense I've grown accustomed to, I must say that clear useful comments even on "obvious" functionality is a must...
@Torbuntu the thing is, the comment is actually
Which is swedish... I probably should have included that in the rant ;)
@RadX But that doesn't even say anything about what it does.
Though, I suppose my comment was only marginally related. I'm more referring to how comments, if made, should at least have some explanation of functionality. Not just the name of the function 🤷♂️... But that's coming from my frustration of seeing jumbled garbage a lot.
Indeed, the comment is completely rubbish. It doesn't say anything and that's why I wanted to remove it.
However, the client wants to keep it ;)
Ileonichwiesz88278dIt's always "meh, I don't need comments, this is self-explanatory" at first.
Please remember that you're not the only one who needs to understand the code. The intern they'll bring in two years from now, when you no longer work there, will have to understand the code. Your boss will have to understand the code when he decides whether to promote you or not.
You lose nothing by adding a line or two of explanation, and it can save hours of time in the future.
Absolutely, if I made a function that does stuff and someone mentioned that I didn't comment it, I wouldn't be ranting about it.
But, revisiting a task to move a completely redundant comment that was written 5+ years ago and doesn't say anything at all about the function makes me question priorities
gorsamp2292278dNo spaces after //? You're a monster!
RAZERZ3195278dSvensk? Ta min uppbåt!
Your Job Suck?
Take a quick quiz from Triplebyte to skip the job search hassles and jump to final interviews at hot tech firms
Get a Better Job