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:[EMAIL PROTECTED] > 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: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > <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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
