W3C home > Mailing lists > Public > public-media-annotation@w3.org > September 2010

improve markup of normative/informative sections for the Ontology spec

From: Thierry MICHEL <tmichel@w3.org>
Date: Mon, 13 Sep 2010 18:18:52 +0200
Message-ID: <4C8E4EEC.2030304@w3.org>
To: "public-media-annotation@w3.org" <public-media-annotation@w3.org>
Per my action Item to improve markup of normative/informative, probably 
with specific class to visualise [recorded in 

here is my proposal:

1- We should mention that all sections not marked as "informative" are 
normative, except for examples.

2- we should add the following markup for informative sections.
a- write "This section is informative."
b- add some styling.

example of markup:

<h2>2.1 <a name="introduction">Introduction</a></h2>

<div class="informative">
<p><em>This section is informative.</em></p>

<p>This is the informative paragraph to be edited ...</p>

and add the following CSS code in an external style sheet:
   .informative { background-color: #eee; border: solid green; 
border-width: 1px; padding: 0.5em;}

here is an example that we had used for SMIL.


Another solution (as we shortly discussed at the F2F, is to say that the 
all spec is normative ...
Received on Monday, 13 September 2010 16:19:00 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:24:42 UTC