News for hackers. Stuff that matters.
Re:Writing system software: code comments by DanFeldman on Sunday October 07, 2018 @01:04PM (#18161557)
I've seen those types of comments everywhere, but only with "junior" devs, or more likely, from people without a CS background. Often these folks haven't had much exposure to clean production code or dug through open source libraries. They're trying to be helpful and document but don't really have the mental models of what needs to be commented or not. This is easy to train away though, through showing examples of what I think needs commenting, or straight up deleting comments during code reviews and by adding Docstrings instead of inline comments.

To be clear, I agree with you about how comments should be used.

There are no comments on this comment yet.