Snap team -
I'm working on converting the HTML backend for Haddock from a nested pile of
tables to XHTML/semantic mark-up. I've been working with the Haddock
maintainer, and slowing pushing small changes into the development branch. I'm
at a point now where I think it is close to release.
I'd love to get your input on particular mark-up I've chosen for various
Haddock constructs. I've uploaded to my web site the documentation for Snap
(core, server and Heist) generated with the new XHTML backend for Haddock:
http://www.ozonehouse.com/mark/snap-xhtml/heist/
http://www.ozonehouse.com/mark/snap-xhtml/snap-core/
http://www.ozonehouse.com/mark/snap-xhtml/snap-server/
The goal of the CSS file was to maintain the look as closely as possible(*), so
no need to focus on that. What I'm after is, if you look at the page in some
XHTML inspector, is the markup what you'd like to see. I basically made it up
as I went along, though I tend to try to use as few classes as possible (put
'em on divs and let selectors work...). If there is anything you'd like to see
different: class tag, different choice of tags, extra div wrappers, I'm very
open to making changes before we go out with it.
Also, focus on the main module pages - the index and associated pages haven't
been fully XHTML'ized yet and we plan to leave those for round two...
Looking forward to finding out what you think.
- Mark
*: First aim: just change the markup without changing the styling, so as to get
the change accepted by the community before we get into the inevitable styling
debates...
Mark Lentczner
http://www.ozonehouse.com/mark/
[email protected]
_______________________________________________
Snap mailing list
[email protected]
http://mailman-mail5.webfaction.com/listinfo/snap
