3 ms·
>> it’s usually the code that needs fixing On larger teams the likelihood than comments get out of date is probably higher - particularly if the original comme
by osigurdson 4y ago
>> it’s usually the code that needs fixing
On larger teams the likelihood than comments get out of date is probably higher - particularly if the original comment was very long and detailed and the original author has moved on.
- AlotOfReading 4y agoThe number of times I've seen obscure code that would have been elucidated by a good comment is vastly higher than the number of times I've seen outdated comments. Funnily enough, most of the outdated comments I can remember were dead docs links despite that being a very common 'solution' to the problem of outdated comments.
- osigurdson 4y agoMy experience is the opposite for the most part.
- AlotOfReading 4y agoWe might read different kinds of code, perhaps? I do lots of systems work where obscure hacks to work around toolchain and hardware issues are common.