cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Mikhail Fedotov" <mikh...@kittown.com>
Subject Re: Cocoon article on JDJ
Date Fri, 07 Jun 2002 16:56:28 GMT
Hi!

> We are perfectly aware of the issues with documentation

...and I'm aware that you are aware of it, sorry for
bothering. :) But...

> and we are moving as fast as we can to improve things,
> believe me, also along with the forrest effort.
> 
> I'm pretty sure that things will be better in time and
> the fact that more and more articles come up is a
> pretty good sign of it anyway.

...but I wanted to say that if there will be _simple_
standardised way to document _anything_ in Cocoon in the
same manner (no matter if it is db action or xsp
logicheet), we can create simple encyclopedy with short
descriptions for all basic and advanced cocoon2 elements,
and things will more faster.

I think it would be highly reasonable to create alphabetic
dictionary of all cocoon elements no matter there they
belongs with short descriptions of them. It should be very
easy to maintaint it, that's why it is a good thing.

This seems to be an important point - if there will be easy
way to create simple and short documentation, more people
will write it, and there will be more documentation. And if
there will be alot of simple documentation, writing of
complex documentation (without repeating basic stuff)
should become easier.

Is there anything like this in forrest ? If it will be
done, it should be integrated in it's structure of course.

Mikhail

---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message