Originally posted by David Crossett:
Did you hand type all the comments and necessary /**, etc.? I was wondering if there are shortcut keys in various IDE's (I use JDeveloper) to insert the various comment characters to speed up typing a bit...I had no idea that code could be so commented...at first it is harder to read (because the comments break up the flow), but I guess in the end it's much better to be able to understand what the coder was thinking and why...thank you...
Originally posted by Stan James:
Re JavaDoc ... if a method needs doc, consider it an opportunity to improve the names and structures until the code explains itself. I put more effort into package and class doc and try hard to not need method doc.