Hacker News new | ask | show | jobs
by factotum 3325 days ago
The problem with comments is that they are too often lies. As the code changes, the comments may not necessarily be updated, and in my experience, they often aren't. Automated documentation and validation are superior to static comments in general. Using a compiled language can help with some of this, and automated tests even more.
1 comments

True, I know the JetBrains IDEs have automated refactoring, and I'm sure other IDEs do this as well, I'm not sure how much of additional overhead it would be to implement an auto comment feature/plugin that handles the job of generating/maintaining comments like #Person refers to columnn people and other things a more explicit language would simply state. Seems like something that could be fairly easily automated.