3 ms·
Yeah, while it's true that a misleading comment can cause more harm than no comment at all, saying code is the documentation is cheating Either we admit we'll
by xwolfi 5y ago
Yeah, while it's true that a misleading comment can cause more harm than no comment at all, saying code is the documentation is cheating
Either we admit we'll never budget maintaining the comments metadata on top of the code, and embrace that risk for the cost reduction it provides, or we do document for real and maintain and review and fix regularly at a cost.
But saying we dont need to do it because it s already done is a quick stunt that everyone saying it knows is dishonest.