4 ms·

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

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