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. Comments? mike Footnotes: [1] except Chapter 3, which is 2 pages.
