It's always the same paradox : the people who need documentation the
most, are the ones that are less qualified to participate in its
writing, otherwise they wouldn't need documentation. For Cocoon
experts, it's a matter of realizing that you can code marvelous
features, if nobody can understand them through a coherent and
accessible documentation, it's totally useless. And when you see
entire blocks (like apples for example) that don't have any
documentation...
So I totally agree : please "skilled people" feel free to participate
in Cocoon documentation effort... but don't be suprised if we newbies
are a little... chomping at the bit !
On Apr 12, 2005 1:31 PM, Reinhard Poetz <[EMAIL PROTECTED]> wrote:
> Nicolas Maisonneuve wrote:
> > Hy,
> >
> > I would like to know the state of the documentation effort.
> > Actually I'm afraid that after the development the new documentation
> > system (another excuse for not beginning the documentation ;-)) ,
> > there won't be a real effort to build a new documentation (= all
> > committers will stop to code et will create a good documentation)
>
> Don't worry, having the new documentation system will not mark the end of all
> our efforts. Upayavira has started to integrate the existing docs into the new
> repository so that they can easily be reviewed. After that we will start to
> fill
> the gaps.
>
> It will take longer than expected (I've had the last weeks less time to work
> on
> Cocoon than expected when I started with the new doc system, and it won't
> become
> better by the end of May) but you can be sure that I will bring my work to an
> end - sooner or later ;-)
>
> Well, if this is too slow for somebody, I'm sure that there are many skilled
> people out there that can jump in ...
>
> --
> Reinhard P�tz Independent Consultant, Trainer & (IT)-Coach
>
> {Software Engineering, Open Source, Web Applications, Apache Cocoon}
>
> web(log): http://www.poetz.cc
> --------------------------------------------------------------------
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
--
Sebastien ARBOGAST
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
