Mike Kupfer wrote: > > The ON Developer Reference is posted at > http://www.opensolaris.org/os/community/on/ using one web page per > chapter[1] because the current portal limits the size of pages to > something fairly small. > > With the move to XWiki in September, we'll have the opportunity to > publish the entire DevRef as a single web page. The source for the > DevRef is currently a single XML file in Docbook format, with some > xsltproc magic to split it into chapters for the community copy. The > original reasons for this setup are historical. It makes it easy to > generate the document in a variety of formats (e.g., HTML or PDF), but > it means additional steps are needed when updating the text. > > So I'm currently thinking that once the site is on XWiki, we should > retire the Docbook version and maintain the DevRef using the XWiki > markup language.
1. I don't think this is a good idea. DocBook is a standard for documentation while the XWiki format is XWiki-specific (or better: application/vendor-specific) and is far less capable than DocBook, e.g. we loose interopabilty, portabilty, all the processing capabilties the DocBook toolschains have and AFAIK there are not many editors which have XWiki markup support. IMO a change from DocBook to XWiki would be a step backwards (e.g. it could be compared to a move from DocBook/SolBook back to nroff). 2. AFAIK the newer DocBook XSLT stylesheets have Wiki support (I think it's MediaWiki bur I am not sure) - did you take a look at that yet ? 3. If we really switch the documentation to the XWiki format... how do we do the output for printed media or embedding the documentation in a larger set of docments (e.g. like a book) ? AFAIK XWiki's support for that can basically be described as "limited to non-existant" ... ---- Bye, Roland -- __ . . __ (o.\ \/ /.o) roland.mainz at nrubsig.org \__\/\/__/ MPEG specialist, C&&JAVA&&Sun&&Unix programmer /O /==\ O\ TEL +49 641 3992797 (;O/ \/ \O;)
