News for hackers. Stuff that matters.

A comment on Reducing technical debt by valuing comments as much as code. Parent comment

Re:Reducing technical debt by valuing comments as much as code by lmm on Tuesday January 31, 2023 @11:47PM (#34606497)
No serious project is anywhere close to "100% comment coverage" either.
[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by vkou on Wednesday February 01, 2023 @01:20AM (#34607137)
I'm not pitching comments as a replacement for all tests, like some are pitching tests as a replacement for all comments.

I'm pitching comments as a compromise when the test that encodes their meaning is impractical.

[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by lmm on Wednesday February 01, 2023 @01:46AM (#34607285)
Combining tests and comments is still not going to get you to 100% coverage though. So for comments to be worthwhile the marginal gain from using them has to outweigh the cost. IME it's usually better to put that effort into better tests/tooling/etc..
[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by latchkey on Wednesday February 01, 2023 @10:35AM (#34611929)
I'm curious, who is pitching for that?
[ Parent | on HN ]