W3C home > Mailing lists > Public > spec-prod@w3.org > January to March 2001

Re: How to mark up examples in W3C technical reports

From: Charles McCathieNevile <charles@w3.org>
Date: Mon, 29 Jan 2001 01:24:30 -0500 (EST)
To: Susan Lesch <lesch@w3.org>
cc: <eve.maler@east.sun.com>, <spec-prod@w3.org>
Message-ID: <Pine.LNX.4.30.0101290107570.21543-100000@tux.w3.org>
On Sat, 27 Jan 2001, Susan Lesch wrote:

  I think SVG access is a valuable model. Instead of caption or table
  header elements you have a figure number and text caption, which make a
  border make sense. The 'strong' markup inside pre brings another
  dimension to examples. The whole effect is meaning-encrusted.

CMN: Thanks Susan <grin/>. I think the use of code elements is still
important - the rest is really a question of presentational markup.

  Eve L. Maler wrote:

  >  is background-color widely enough supported to be "safe"?
SL:
  It is unsupported in IE 3 on Macs at least. In the case above,
  body is white, and background renders in stair steps so there may be
  some use for background-color. (It shouldn't be used for example to
  reverse colors in table headers. If body was white, background-color
  was black, and text color was white, the header would be invisible.
  That might be what Eve is referring to.)

CMN: Right. Using a slightly different colour combination means that you can
get the best of both worlds - enough contrast (with the bordser and other
devices) to make the examples stand out, with enough to know that if only
some properties work the whole thing is still legible.

cheers

Chaals
Received on Monday, 29 January 2001 01:24:35 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 10 March 2012 06:19:11 GMT