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

The article talks about 'lots of comments'. The occasional comment can be helpful but many things are just as clearly expressed in code as in comments. E.g., if you write a numerical algorithm you should probably either explain it or add a reference. But if you start to see things like

    DatabaseConnection conn; // Connection to the database
things have gotten very badly out of hand.



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

Search: