Hacker News new | ask | show | jobs
by cjfd 2415 days ago
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.