Now Apache has two major sectors about Java: XML and Jakarta. Actually
the two sectors have interacted a lot, and as its result, there have
been also several various ideas for documentation.

Originally XML brought out stylebook as an ant task, which currently
seems obsolete somehow. For its alternative, Velocity Anakia appeared.
It utilizes Velocity template technology with xml documents, however,
does not go with XSLT.

Velocity DVSL is slightly different from Anakia in this sense. As you
see the initials as Declarative XML Transformation and Templating, DVSL
"steals" some features of XSLT, but "still" sticks to Velocity template
language.

Meanwhile, XML Forrest came up as a sort of "ASF" representative
documentation system. Forrest is purely based on XML technologies such
as XML itself, XSLT, DTD, and possibly even XML Schema some day. Its
range is also remarkable: Ant, Centipede, Cocoon, Gump, Scarab, Slide,
and etc... All the names are on the page of the Forrest Primer.

At this very moment, I suggest that we be as considerate as possible for
next generation documentation system for the cactus project. IMHO,
stylebook is naturally connected to Forrest, so it might be smooth and
promising to choose Forrest.

Here's a summarized table of each technology:
            document     template      (relative) stability
Stylebook XML           XSLT          (literally) too stable
Anakia     XML           Velocity      stable
DVSL       XML           Velocity      CVS stage
Forrest   XML           XSLT           CVS stage

Thank everyone in advance.

IAS

Independent Java Technology Evangelist
http://www.iasandcb.pe.kr

Jakarta Seoul Project Coordinator
http://jakarta.apache-korea.org 




--
To unsubscribe, e-mail:   <mailto:cactus-dev-unsubscribe@;jakarta.apache.org>
For additional commands, e-mail: <mailto:cactus-dev-help@;jakarta.apache.org>

Reply via email to