Reply to post: Reflection on the author...

Linus Torvalds in sweary rant about punctuation in kernel comments

Herby Silver badge

Reflection on the author...

Comments, while not used by the compiler, are written by the same person who writes the code. In general, one reflects upon the other. If you see "bad (sloppy) comments", there is (I suspect) a similar fate for the code in general.

So, if you see bad code (and that is everywhere!), bad comments are not far behind. So, cleaning up comments to reflect the code in general is probably a "good idea".

Just remember:

Bad, or incorrect comments are worse than no comments at all. Documentation is something that needs to be done.

POST COMMENT House rules

Not a member of The Register? Create a new account here.

  • Enter your comment

  • Add an icon

Anonymous cowards cannot choose their icon

Biting the hand that feeds IT © 1998–2019