News for hackers. Stuff that matters.
Re:On Comments in Code by xwolfi on Tuesday June 15, 2021 @08:23PM (#27523363)
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.

There are no comments on this comment yet.