tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Remy Maucherat" <r...@apache.org>
Subject Re: [Catalina] Global docs directory...
Date Fri, 11 Aug 2000 20:33:11 GMT
> "Pier P. Fumagalli" wrote:
>
> > "Craig R. McClanahan" wrote:
> > > +1 for "docs" and "docs/images".
> >
> > Yes, and also for a bunch of "generic" documents, explaining maybe the
> > relations between the different parst of the proects, blablabla... Yep,
> > we need a "shared" docs dir.
> >
>
> Can I suggest that we plan on having HTML documents as the ultimate output
> (either by writing HTML directly or by using XML sources plus XSLT
stylesheets
> and the new Ant <apply> tag)?  That way, the "docs" subdirectory can be
> packaged as a web application itself.

I do that in Slide. I have XML documentation and a bunch of (hacked to the
death) stylesheets. I then use the <style> taskdef in Ant to generate HTML
documentation.

I think it would be a good idea to do the same in Tomcat.

> I did this with Struts, and it makes things nice in several ways -- you
can
> include diagrams without having to resort to ASCII art, you can link in
"live"
> demos of features, you can use JSP pages for dynamically generated docs if
> this is useful, and so on.

Remy


Mime
View raw message