Return-Path: Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm Delivered-To: mailing list cocoon-dev@xml.apache.org Received: (qmail 76759 invoked from network); 18 Sep 2000 22:37:35 -0000 Received: from pop.systemy.it (194.20.140.28) by locus.apache.org with SMTP; 18 Sep 2000 22:37:35 -0000 Received: from apache.org (pv9-pri.systemy.it [194.21.255.9]) by pop.systemy.it (8.8.8/8.8.3) with ESMTP id AAA11231 for ; Tue, 19 Sep 2000 00:37:33 +0200 Message-ID: <39C68E34.2DFDF079@apache.org> Date: Mon, 18 Sep 2000 23:50:44 +0200 From: Stefano Mazzocchi Organization: Apache Software Foundation X-Mailer: Mozilla 4.74 [en] (Windows NT 5.0; U) X-Accept-Language: en,it MIME-Version: 1.0 To: cocoon-dev@xml.apache.org Subject: Re: C2 documentation (was: [C1] The new FAQs...) References: <39C4119E.392DF8B1@apache.org> <009901c0207d$34a39330$d2022397@ARES> <39C4915F.A74AF434@apache.org> <39C66CD3.13F5BD94@mail.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Spam-Rating: locus.apache.org 1.6.2 0/1000/N Ross Burton wrote: > > Hans Ulrich Niedermann wrote: > > > How will this work btw? We were talking about migrating our docs to > > Docbook in the future but Docbook XSL stylesheets won't generate the > > Stylebook xml.apache.org look & feel without major additions. And I > > don't have any idea of how to integrate Document DTD, Stylebook > > generated pages smoothly with Docbook DTD, Docbook XSL generated > > pages. > > I'm +1 on using some form of DocBook for the documentation, using a > non-standard DTD when a standard one exists is silly. However, DocBook > is rather complex but I have heard of the Simple Docbook DTD - how > "simple" is this, or should we create a custom Docbook DTD like the > Simple DTD. Agreed, but I want to leave the ability for people to write things using our simple DTD, so I'll write an adapting XSLT stylesheet (whenever possible..) but I have code to write now... > Ross, contemplating buying the O'Really Docbook guide look at www.docbook.org it's there for free. -- Stefano Mazzocchi One must still have chaos in oneself to be able to give birth to a dancing star. Friedrich Nietzsche -------------------------------------------------------------------- Missed us in Orlando? Make it up with ApacheCON Europe in London! ------------------------- http://ApacheCon.Com ---------------------