4 ms·
I have to object here and say that out-of-date comments are better than no comments. I've worked in organizations with "no comments" policies and having no clue
by strictfp 5y ago
I have to object here and say that out-of-date comments are better than no comments. I've worked in organizations with "no comments" policies and having no clue what people ever planned to achieve with a piece of code is worse than some old misguided explanation for sure.
- emodendroket 5y agoI wouldn’t support a no-comment policy, but I’ve wasted a lot of time thanks to misleading comments.
- hiptobecubic 5y agoYou have to assume that comments are out of date, then it's easier to make use of them.
- emodendroket 5y agoBut out of date in which way? It could be anything from some extra cases to literally the opposite of what the comment says to the code has changed so much it’s not even clear what the comment refers to anymore.
- jimmyvalmer 5y agoNotices a kindred spirit You get it. I get it. Unfortunately every intro class inculcates generous commenting, a "best practice" further promoted by corporate proceduralists and mediocre programmers who inexorably become managers. A comment longer than 160 characters is always weak-sauce justification for logic written awkwardly.
- emodendroket 5y agoFor the most part comments I appreciate are something like "the obvious thing here is xyz, but we can't do that because of this goofy limitation of software we're integrating with."