John Maddock wrote:
> Rene Rivera wrote:
>> I'll see... One of the big things I noticed in the recent docs is
>> using tables for the admonitions.
> 
> Hmmm, I'm not sure if that's us or the docbook stylesheets.  Looks OK, 
> what's wrong with a table here (sorry for the dumb question)?

Because tables are a structural element. Using them for admonitions is 
subverting the meaning of the content. One effect is that in the web 
site it looks like a table, since I put in the different style. This 
style issue is not limited to the web site, users are free to put in 
their own style at a whim. The ideal is that when you switch off the 
default style, like Firefox allows, the page is still readable. Another 
effect would be that someone using a non-visual page reader would be 
misled and confused by content that claims to be a table, but isn't.

>> Maybe this is something Matias could do. Since it would help
>> tremendously if we move the docs to this decade. Especially as it
>> opens them up to a wider audience.
> 
> Don't you mean this century ? :->

I'm holding out hope that by the next decade something better will come 
up ;-)

And of course I haven't yet mentioned passing the WAI conformance tests.

-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo

-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to