2 ms·
> reject most comments: they're an additional maintenance cost that can't be automated. I have a really hard time reconciling this with my experiences. Sure, o
by gknoy 6y ago
> reject most comments: they're an additional maintenance cost that can't be automated.
I have a really hard time reconciling this with my experiences. Sure, often times comments that explain _what_ is happening can go stale, but I have frequently spent hours debugging, asking in Slack, and picking the collective brains of other developers for a codebase to understand why we do X, or what some test is meant to represent, when a thorough comment ("This tests feature X... for product Y...") could have made it easier to recognize that certain behavior can be removed ("Oh wait that's for this product/workflow which we don't even do anymore -- it's safe to just delete that entire thing"), or understand the nuances of why the Simple Seeming way of doing something is wrong.