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 paulddraper on Tuesday January 31, 2023 @03:26PM (#34601430)
What question will the next engineer have about your choice?

1. Rewrite your code to make the answer obvious.

2. If that's not possible use a comment.

[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by layer8 on Tuesday January 31, 2023 @06:52PM (#34604137)
3. Be aware that programmers are usually bad at judging what is “obvious” about their code.
[ Parent | on HN ]