News for hackers. Stuff that matters.
Re:Writing system software: code comments by karmelapple on Sunday October 07, 2018 @11:39AM (#18161082)
Tests are what matter to me and my team, too. Tests = requirements.

As another commenter pointed out, we use comments for why. Sometimes the commit history can help this, but a well-placed comment can shrink that effort.

I get a feeling we may not pass OP’s litmus test, but I’d be curious if we would. We use the term self-documenting code, but that’s primarily because our tests are part of our code, and those tests are indeed our primary documentation.

There are no comments on this comment yet.