Re: Tapestry Component documentation

[Howard Lewis Ship <hl...@gmail.com>]

In 3.0, the compnent documentation is pure HTML, which is a pain to maintain.

In 3.1, the component documentation is in Forrest XML doc format. 
However, only a couple of components have been documented.

The 3.1 documentation is currently at http://jakarta.apache.org/~hlship/tapestry

There was talk about an Ant tool that could extract some of the
documentation from the .jwc file directly. Especially in 3.1, there's
less and less information that can be extracted from the .jwc file
(for example, parameter type and direction is no longer part of the
.jwc file) ... and, given the emphasis on the how? and why? (over the
what?) in the component reference, it will continue to be a manual
process to maintain, I think.


On Thu, 30 Dec 2004 13:43:20 -0800 (PST), Chris Nelson
<cn...@yahoo.com> wrote:
> As part of Trails, I have built a bunch of Tapestry
> components, and I want to start documenting them.  Can
> someone give me a rundown on how the current Tapestry
> Component Reference pages are built?
> 
> Thanks in advance,
> 
> Chris Nelson
> 
> __________________________________
> Do you Yahoo!?
> Yahoo! Mail - 250MB free storage. Do more. Manage less.
> http://info.mail.yahoo.com/mail_250
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: tapestry-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: tapestry-dev-help@jakarta.apache.org
> 
> 


-- 
Howard M. Lewis Ship
Independent J2EE / Open-Source Java Consultant
Creator, Jakarta Tapestry
Creator, Jakarta HiveMind

Professional Tapestry training, mentoring, support
and project work.  http://howardlewisship.com

---------------------------------------------------------------------
To unsubscribe, e-mail: tapestry-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tapestry-dev-help@jakarta.apache.org