3 ms·
One of the main rants in this is about superfluous comments. I completely agree that comments which are superfluous should be removed. However all his examples
by Velox 12y ago
One of the main rants in this is about superfluous comments. I completely agree that comments which are superfluous should be removed. However all his examples are JavaDoc. Yes, in the code they are useless because of the variable declarations, however they are of great use in an IDE.
- hadem 12y agoI was thinking the same thing. Yes, the comments might look pointless when viewing source code on GitHub but really makes life easier with an IDE and documentation generation. Sure, take out those comments, but then his next blog post would be about the lack of decent documentation available for various projects...
- peeters 12y agoAnd most syntax highlighters actually allow different styling on Javadoc comments than on block comments or line comments. There's no reason to treat them the same.