> -----Original Message----- > From: Stephen Colebourne [mailto:[EMAIL PROTECTED] > 3) Javadocs are sometimes thin. On occasions, they are written as > paragraphs > visually but without the HTML <p> tag. (eg. UnivariateRealSolver) or > missing, eg StandardDeviation [Tim O'Brien]
Agree, JavaDocs are somewhat thin and in some cases we just reference some other web site. (i.e. ComplexMath simply has a URL: http://myweb.lmu.edu/dmsmith/ZMLIB.pdf ). A good benchmark to use is Digester, our "users" should be able to use a commons component without needing to look at the source, and having fuller JavaDoc goes a long way towards this goal. So, be warned, I'm using Bugzilla as a task list. Tim --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
