> From: Aaron M. Renn [mailto:[EMAIL PROTECTED]]
>
> >> 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.
>
Amen brother Renn! Also, it's easier to write when it's fresh in your mind.
You know all the things that a programmer might need to know when calling
your API.
--John Keiser
