There's truth to both sides. Depends on the comment really. ``` doesAThing() //d... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		drbojingle on June 7, 2019 \| parent \| context \| favorite \| on: Absolute truths I unlearned as junior developer 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.

TimTheTinker on June 7, 2019 [–]

> 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".

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact