Hacker News new | ask | show | jobs
by errcorrectcode 1596 days ago
Not all code can be self-documenting, especially optimized algorithms and complex operations. Comments serve to add requisite context and clarification that code alone cannot provide. Simply regurgitating the obvious in comments is a waste.
1 comments

yes, agreed. good document is about why, not what.