Hacker News new | past | comments | ask | show | jobs | submit login

Indeed. Comments should document intent and – wherever applicable – approaches taken that did NOT work and why. Even awkward code is sometimes okay, if there’s a comment with a clear justification. Saves hours of pointless busywork following down all the paths in a medium to large code base.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: