News for hackers. Stuff that matters.

A comment on Absolute truths I unlearned as junior developer. Parent comment

Re:Absolute truths I unlearned as junior developer by drbojingle on Friday June 07, 2019 @12:33PM (#20126299)
There's truth to both sides. Depends on the comment really.

``` doesAThing() //does a thing ```

doesn't help anyone.

My rule: Code is for how, comment is for why.

[ Parent | on HN ]
Re:Absolute truths I unlearned as junior developer by TimTheTinker on Friday June 07, 2019 @03:13PM (#20127712)
> Code is for how, comment is for why.

Excellent. For interfaces, other code that uses the interface (perhaps even tests) can also help to document the "why".

[ Parent | on HN ]