Seems by taking myself offline (on purpose) for the weekend,
I've come late to this party. Is it BYOB (Bring Your Own
flame-Bait? :)
Sam Ruby wrote:
> And I can tell you that xerces2 and axis are completely out
> of spec...
I'm working on changing that as we type. I'm doing a nearly
complete rewrite of the Xerces2 docs in preparation for an
upcoming beta release.
> 1) Stylebook can be configured to use virtually any layout
> desired, but the one chosen by the XML project is too graphics
> heavy.
After I finish writing up the docs in the current format, I'm
going to be looking at bending the StyleBook stylesheets (not
the engine) to my will so that I can create a whole new look
for Xerces2. If I'm able to do that, then I will definitely
making it much less graphics heavy.
Even though I'm using the current style, I have modified the
stylesheets a *little* bit to fix some bugs and some missing
tags that I need. But I'm not going to mess with the overall
style until I feel confident in how it all works together.
> 2) Stylebook itself is not exactly maintained (Cocoon2 has
> been threatening to replace it for ever)
I'll finish reading the rest of this thread before I ask the
following questions:
[Q] Is Cocoon2 ready? (and how big is it?)
[Q] Can it be used in stand-alone mode?
> 3) The process for actually generating the site using
> stylebook is cumbersome at best. [...] And the process
> of knowing what generated files to check in is very error
> prone.
No argument here.
But I'm fully in support of continuing to use Xerces and
Xalan to build our docs. Now whether that's done with the
StyleBook tool (which is quite small and very flexible if
only we knew how to use it!) or Cocoon2 (which is supposed
to be the biggest baddest dude on the block), I don't care.
However, I *would* like the tools required to build the
docs be as small as possible, though.
--
Andy Clark * IBM, TRL - Japan * [EMAIL PROTECTED]
---------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
