I've taken a look at Hibernate's DocBook usage and it appears to cover most of what the Tomcat
documentation needs (chapters, paras, lists, code snippets, tables), but as you say, I will
experiment with a chapter or two and upload it somewhere for you to take a look, hopefully
it will be worthwhile ...
Will be in touch, Allistair.
> -----Original Message-----
> From: Remy Maucherat [mailto:remm@apache.org]
> Sent: 06 September 2005 15:36
> To: Tomcat Developers List
> Subject: Re: [ANN] Servlet and JSP APIs have moved to subversion
>
>
> Allistair Crossley wrote:
> > Hi Remy,
> >
> > I've been thinking about the Tomcat online documentation for quite a
> > long time now, and have wanted to do something to enhance them for
> > the community. I think I am going to be able to get back to doing
> > this shortly. I've been looking at how other open-source projects
> > that I consider to be very well documented approach documentation,
> > and was most impressed with Christian Bauer's use of DocBook for
> > Hibernate's HTML and PDF documentation. DocBook is a schema for
> > defining "books" and one uses XSL to translate to HTML or PDF
> > renditions. I've set this up on my PC and have purchased a
> decent XML
> > editor for the task, but I'm keen to learn whether you
> would consider
> > even approaching the documentation differently.
>
> Ok, feel free to experiment. The main drawback is that the
> DTD is more
> complicated. Besides that, it would produce better results.
>
> Rémy
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org
>
>
<FONT SIZE=1 FACE="VERDANA,ARIAL" COLOR=BLUE>
-------------------------------------------------------
QAS Ltd.
Registered in England: No 2582055
Registered in Australia: No 082 851 474
-------------------------------------------------------
</FONT>
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org
|