A Senior Developer working mostly with PHP and JavaScript, with a bit of Python thrown in for good measure, all on Linux. My tooling is simple, it's GitLab and JetBrains where possible.
For the sake of no. 19, what drives me insane is people not writing comments :D Try debugging anything a bit more complex or code you see for the first time and you start appreciating comments quickly. Remember, what's self explanatory to you, might not be for someone else. Or for yourself in a year, for that matter... And I agree with Gary, not talking about arbitrary comments.
I'm Ibne Nahian, your web wizard! With expertise in WordPress, PHP, JavaScript, and more, I transform ideas into stunning websites and automate tasks. Let's make your digital dreams a reality!
Think about this, comments are often not maintained well and can be misleading.
Better to have no comments, than misleading ones.
If the code is clear enough, comments are almost never needed.
Code can't never been self explanatory for everybody, you need the right comments at the right place. I don't like javadocs but sometimes a line of comment in the right place is all you need.
Some code should be commented, for example any code which is very specific to a domain problem and appears counterintuitive.
Comments for the sake of comments - like "looping through array" - are annoying
Totally agree. I follow "Clean Code" by Robert Martin. If it needs to be commented, that means it's not clear enough
Which can be a good thing of course, in case anyone reads this and thinks all good code must be self-explanatory.
"Code that is not clear" is not necessarily "bad code".
For the sake of no. 19, what drives me insane is people not writing comments :D Try debugging anything a bit more complex or code you see for the first time and you start appreciating comments quickly. Remember, what's self explanatory to you, might not be for someone else. Or for yourself in a year, for that matter... And I agree with Gary, not talking about arbitrary comments.
That's why I said codes should be self explanatory.
And that's why I said "what's self explanatory to you, might not be for someone else" :D
Think about this, comments are often not maintained well and can be misleading.
Better to have no comments, than misleading ones.
If the code is clear enough, comments are almost never needed.
Clean code should be self explanatory. It should rarely require comments
Code can't never been self explanatory for everybody, you need the right comments at the right place. I don't like javadocs but sometimes a line of comment in the right place is all you need.
Indeed, been caught out by our of date comments before.
Plus a lot of comments don't even make sense sometimes