On Tue, Sep 27, 2011 at 07:49:37AM -0400, Jesse Glick wrote: > On 11/19/2010 02:19 PM, Kristian Rosenvold wrote: > > if it hurts you, make a patch; documentation upgrade, javadoc or code > > changes > > The difficulty with submitting Javadoc changes is that if you need > the Javadoc you probably are not going to be sure what it should > say. :-)
I am always amused (and saddened) to read that the documentation should be written by those who do not understand the code. It is possible to do this tolerably well. It's exhausting, but it *is* an effective way to get to know the product better -- eventually. And there are still gaps: places where it's simply not feasible to divine what the author was thinking when he wrote *that*. -- Mark H. Wood, Lead System Programmer [email protected] Asking whether markets are efficient is like asking whether people are smart.
pgpTwqP8dW0nx.pgp
Description: PGP signature
