Hacker News new | ask | show | jobs
by cratermoon 1756 days ago
If someone takes a dozen lines of convoluted code to express what can be done in 2-3 lines concisely, the explanation isn't going to help. Think of the worst mess of if/then/else clauses you've seen, or someone who switches on a type instead of using polymorphism. Even if they can explain it well enough that you can follow it, the comments aren't going to improve the understanding much. They are more likely to add cognitive load and make it harder to grasp the intent.
1 comments

Comments are not for fixing bad code, comments are for explaining complex (and good) systems.