3 ms·
Next time someone says "well-written code doesn't need comments" I think I will just refer them to this page.
by wrs 4y ago
Next time someone says "well-written code doesn't need comments" I think I will just refer them to this page.
- nerpderp82 4y agoWe all know that is just an excuse for no comments. I haven't heard anyone say that in over 5 years.
- gpm 4y agoI'll doubt they'll find it to be a convincing argument, because it relies on a fairly uncharitable interpretation of the claim. Rather than interpreting it as "literally no well-written code needs comments" I would interpret it as "well-written code doing straightforward things (like most code is doing) doesn't need comments". Complex algorithms trying to quickly approximate a np-hard search problem in a complicated environment are a fairly obvious exception to the rule, even if you believe the rule is almost always applicable. I'm also not sure when the last time I heard someone seriously make this claim was...