> As is, it tends to have all three diseases at once and I'm not sure what the cure is except screaming "do better!" Code reviews with people who give a shit h

> As is, it tends to have all three diseases at once and I'm not sure what the cure is except screaming "do better!" Code reviews with people who give a shit helps. I'll commonly suggest specific areas for comment in reviews. And I'll mercilessly delete redundant or just plain wrong comments. Sometimes they were clearly copy+pasted from another method (and thus not right in the first place). I assume they wanted to copy the doc-comment syntax and meant to fix it up later, but then never did...