3 ms·
I dislike the last example he gives, even though the reason may be a decent one. Having Doc Comments in Java, for example, is great because Eclipse (and other I
by ilyanep 13y ago
I dislike the last example he gives, even though the reason may be a decent one. Having Doc Comments in Java, for example, is great because Eclipse (and other IDEs) will actually explain to you what a function does when it does code completion and the format for those comments looks exactly like that example.
Overall, there are some very good points expressed in the article. I feel like the fact that new programmers are taught to comment a lot is good (completely uncommented code is often horrid, and let's be honest, new programmers often won't write good code). Perhaps there should be a stage later on (and maybe there is) where programmers with more experience are taught that they should actually avoid comments in general and just write good code (with the exception of doc comments, as I mentioned above).