Hacker News new | ask | show | jobs
by toomanybeersies 1831 days ago
I agree in principle. If it takes more than more than a second to grok what a particular bit of code is doing, it should have a comment (or be extracted into a method).

However, in my experience, it's common for either:

1. Code to get changed, but the relevant comments are unchanged, or

2. Comments that are just as hard to understand as the code

In both cases, it's even harder to understand the comment+code than if there was no comment at all