RE: [boost] Re: JavaScript index?

From: Paul Mensonides (pmenso57_at_[hidden])
Date: 2004-10-04 13:33:43

> -----Original Message-----
> From: boost-bounces_at_[hidden] 
> [mailto:boost-bounces_at_[hidden]] On Behalf Of Reece Dunn

> [1] Generate XHTML documents with an XSLT stylesheet to 
> transform them to HTML and handle an xi:include directive 
> (within the stylesheet if the XSLT engine does not support 
> them). This would allow the ToC to be maintained in a 
> separate file, keeping doc bloat to a minimum.
> 
> This is not really a workable solution because of 
> incompatibilities and browser support isuues. Also, you will 
> be transforming the document at the client site each time 
> they view a page, taking up resources on the client machine.

The documentation can be built during the build process on a client
machine--which can be parametized by the particular user's preferences--i.e.
there can be more than one available XSLT transformation.  There are always
going to be people that prefer fancy versions and people that prefer baseline
versions, and there is no way to please everybody at once without having
multiple ways to view the same docs.

Regards,
Paul Mensonides