3 ms·
The issue I’ve seen in older codebases is comments not being updated when the corresponding code updates. This usually is more of a problem for comments that a
by dugmartin 3y ago
The issue I’ve seen in older codebases is comments not being updated when the corresponding code updates. This usually is more of a problem for comments that are not local to the code, whether they are in docs or in a separate code file. Once enough of that creeps in you start distrusting comments and thus stop reading them.