Max Bowsher wrote:
> Karl Fogel wrote:
>> Max Bowsher <email@example.com> writes:
>>> I've resurrected the Design Document XML on a temporary basis.
>>> My reason for doing this is that the current converted design.html
>>> contains numerous errors in the markup - which there's really no reason
>>> for, considering the source is a fully valid DocBook document.
>>> Therefore, it is my intention to construct some XSLT to perform the
>>> conversion to HTML in a well defined and rigorous fashion.
>>> I have a mostly-working transformation already, by way of private
>>> proof-of-concept. I'll tidy it up a little more, and commit it into the
>>> doc/design directory. People can comment, and adjust the transformation
>>> if necessary, then we can run it for a final time, replace the current
>>> design.html with the XSLT-transformed one, and then delete doc/design again.
>> Okay. I was just about to go hack on www/design.html to start
>> bringing it up-to-date, but I'm happy to wait until you've committed a
>> more rigorous one. Thanks for doing this the "right" way, Max; I
>> don't know much about constructing XSLT translations and just Wanted
>> It Done, but your way will be better.
> Right - a new version of www/design.html is now in place.
> Please review it, since it would be nice to make any possible changes
> that can most easily be addressed by modifications to the XSLT before
> manual edits are made to the HTML directly.
> Once we're happy that we won't be needing to reconvert from the DocBook,
> the doc/design directory can be deleted.
It looks good, mostly. I think might want to update the embedded license
statement. And I don't uderstand why the section divisions have both
"id" and "title" attributes; I thought "id" was enough to make the TOC work?
> Once we are happy, I intend to make a sweep through design.html fixing
> up the indentation - when I do so, should I work to a textwidth of 70,
> 72, or 79 ?
79 is prime. :)
To unsubscribe, e-mail: firstname.lastname@example.org
For additional commands, e-mail: email@example.com
Received on Tue May 30 20:30:49 2006