On Tue, Apr 17, 2012 at 02:40:53PM -0400, Thiessen, Todd (Todd) wrote: > Good read. > > Documentation can be much better, but I suppose it is up to us as community > members to make that happen. Maven isn't owned by anyone. The guys at > Sonatype have done a good job of posting various blogs. If anyone has the > time and desire I am sure she/he could pull many of these various tid bits of > good practices into one coherent doc. > > I think it says something that it has not been done yet. While everyone says > it would be great to have, clearly no one has felt strongly enough about it > (yet) to make it happen. It is more of a very nice to have than a hard and > fast requirement.
Or, perhaps no one who feels strongly about it also feels he understands it well enough to write something worth reading. I could write reams of misleading rubbish but what purpose would that serve? I've written documentation for other people's code. It's exhausting, incredibly time-consuming, and often unsatisfactory. The whole reason I wanted documentation was because I didn't understand the product -- if I were in a position to document it well, I wouldn't need the documentation so badly! -- Mark H. Wood, Lead System Programmer mw...@iupui.edu Asking whether markets are efficient is like asking whether people are smart.
pgpvIm8dwK3Dy.pgp
Description: PGP signature
