Re: [CSS21] Examples

On Saturday, August 27, 2005, 11:04:35 PM, Ian wrote:

IH> On Thu, 25 Aug 2005, Chris Lilley wrote:
>> 
>> Hello ,
>> 
>> This comment is sent from both the CDF WG and the SVG WG.
>> 
>>   Examples usually have the word "example" near their start ("Example:",
>>   "The following example?," "For example," etc.) and are shown in the
>>   color maroon, like this paragraph.
>>   http://www.w3.org/TR/2005/WD-CSS21-20050613/conform.html#q1
>> 
>> Why 'usually'?

IH> Because it depends on the configuration of the user agent.

Which, the color or the text?

If the latter, please state that the author style sheet adds the word
Example and that the user style sheet might over ride this (if that is
what is happening). If not, then I don't understand your comment about
configuration.

>> How then can a non-normative example be distinguished from normative 
>> content. Please clearly mark-up all examples in a consistent way. Please 
>> use document structure rather than color alone to indicate important 
>> information.

IH> All examples have the word "example" in their "class" attribute, which is
IH> (as described in that section) used to style the paragraphs appropriately.

Great. Please say so in the spec.


>> Incidentally, "this paragraph" was in black, not maroon, when using 
>> several modern HTML browsers.

IH> Yes, the draft had a publication error (it is missing some stylesheets due
IH> to W3C mirroring problems). This will be rectified before future 
IH> publication.

IH> Please let us know if this addresses your concerns.

I suspect it will, yes.


-- 
 Chris Lilley                    mailto:chris@w3.org
 Chair, W3C SVG Working Group
 W3C Graphics Activity Lead

Received on Tuesday, 30 August 2005 01:20:45 UTC