>> And we don't automatically generate JavaDoc, but we are in a special
>> position in that Java is already very well documented and at this
>> stage we're just replicating, not innovating.
>
>Java does not have good free manuals. Free software needs good free
>documentation <URL:http://www.gnu.org/philosophy/free-doc.html>. You
>can expect me to work heavily on the free documentation side of things
>once we replace Sun's proprietary libraries.
I think it is a very good idea for people to at least write javadoc comments
of equivalent quality to Sun's while writing the actual classes themselves.
Perhaps Paul is an exception to the rule, but I don't think most programmers
particularly enjoy documentation. By creating the docs as we go, we reduce
the pain involved and increase the likelihood that the documentation job
will get done.
--
Aaron M. Renn ([EMAIL PROTECTED]) http://www.urbanophile.com/arenn/
