Yes, you *could* rely on your IDE to show you the Javadoc *for the class or method you're currently focused on*. But then you'd miss seeing that you forgot to write the overview, you forgot to write most of the package comments, or that 80% of your classes and methods have either no topic sentence, a useless one, or one that is bizarrely formatted and unreadable. Or the amount of material that doesn't really say anything which would help someone not already intimately familiar with the code. Documentation should be generated and reviewed regularly.
-- Mark H. Wood, Lead System Programmer mw...@iupui.edu Asking whether markets are efficient is like asking whether people are smart.
pgptFSx7Kd4SD.pgp
Description: PGP signature