top | item 36549280

(no title)

Makhini | 2 years ago

As it has been said bazillion of times, the problem is that comments get outdated quickly. And yes, there is self descriptive code,and I'd wager 80 percent of the code is self descriptive. Comments should be reserved to describe something that might be surprising or not obvious. And for the apis.

discuss

order

tziki|2 years ago

Self commenting code gets outdated quickly too. Not the code itself, but the names. Just because a developer managed to embed their comments into function and variable names doesn't suddenly make them immune to staleness.