cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Simmons" <deri...@arcor.de>
Subject Re: Cocoon 2.1 the usability release?
Date Mon, 27 Jan 2003 12:03:17 GMT
Oh well, I don't mean to be caustic but developers that work for me that
don't document get yelled at allot. I don't tolerate it. Its quite easy to
javadoc as you go and a massive pain in the ass to do it after the fact. With
the lack of documentation though, it does make one wonder what is lurking in
there that isn't needed anymore. But then I still think a usability focused
release would be a good thing. Hell, Id be willing to do the Log4j conversion
when I get done with my current project.

-- Robert


----- Original Message -----
From: "Jeff Turner" <jefft@apache.org>
To: <cocoon-users@xml.apache.org>
Sent: Monday, January 27, 2003 1:00 PM
Subject: Re: Cocoon 2.1 the usability release?


> On Mon, Jan 27, 2003 at 01:28:30AM +0100, Robert Simmons wrote:
> > One other feature would be more extensive documentation in the API. To
> > see what I mean, look at the class level documentation on
> > LinkSerializer. Hrmm ... I still don't know what it does. Perhaps its
> > time to bust people's chops to document things.
>
> I'm glad to see you consider good documentation a priority.  I have
> commit access to the relevant repositories, and I am willing to document
> anything you like for a very reasonable $A10/class.  Please contact me
> offlist for further information.
>
> Of course... I ASSUME you'd be willing to pay someone, because how else
> could you get volunteers to scratch YOUR particular itch? :)
>
>
> --Jeff
>
> > What I meant about the component documentation, by the way, is
> > basically what is listed if you look at the package page in the API for
> > the various components.
> >
> > -- Robert
> ...
>
> ---------------------------------------------------------------------
> Please check that your question  has not already been answered in the
> FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>
>
> To unsubscribe, e-mail:     <cocoon-users-unsubscribe@xml.apache.org>
> For additional commands, e-mail:   <cocoon-users-help@xml.apache.org>
>


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <cocoon-users-unsubscribe@xml.apache.org>
For additional commands, e-mail:   <cocoon-users-help@xml.apache.org>


Mime
View raw message