[html5] r2585 - [e] (0) Tone down the rhetoric around the <i> element being a last resort, as it [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2008-12-25 00:47:15 -0800 (Thu, 25 Dec 2008)
New Revision: 2585

Modified:
   index
   source
Log:
[e] (0) Tone down the rhetoric around the <i> element being a last resort, as it doesn't really help authors to say this. (credit: hs)

Modified: index
===================================================================
--- index	2008-12-25 08:11:02 UTC (rev 2584)
+++ index	2008-12-25 08:47:15 UTC (rev 2585)
@@ -13814,21 +13814,16 @@
 <p>Raymond woke with a start as the fire alarm rang out.</p></pre>
   </div>
 
-  <p>The <code><a href=#the-i-element>i</a></code> element should be used as a last resort when
-  no other element is more appropriate. In particular, citations
-  should use the <code><a href=#the-cite-element>cite</a></code> element, defining instances of
-  terms should use the <code><a href=#the-dfn-element>dfn</a></code> element, stress emphasis
-  should use the <code><a href=#the-em-element>em</a></code> element, importance should be denoted
-  with the <code><a href=#the-strong-element>strong</a></code> element, quotes should be marked up
-  with the <code><a href=#the-q-element>q</a></code> element, and small print should use the
-  <code><a href=#the-small-element>small</a></code> element.</p>
-
   <p>Authors are encouraged to use the <code title=attr-class><a href=#classes>class</a></code> attribute on the <code><a href=#the-i-element>i</a></code>
   element to identify why the element is being used, so that if the
   style of a particular use (e.g. dream sequences as opposed to
   taxonomic terms) is to be changed at a later date, the author
   doesn't have to go through the entire document (or series of related
-  documents) annotating each use.</p>
+  documents) annotating each use. Similarly, authors are encouraged to
+  consider whether other elements might be more applicable than the
+  <code><a href=#the-i-element>i</a></code> element, for instance the <code><a href=#the-em-element>em</a></code> element for
+  marking up stress emphasis, or the <code><a href=#the-dfn-element>dfn</a></code> element to mark
+  up the defining instance of a term.</p>
 
   <p class=note>Style sheets can be used to format <code><a href=#the-i-element>i</a></code>
   elements, just like any other element can be restyled. Thus, it is

Modified: source
===================================================================
--- source	2008-12-25 08:11:02 UTC (rev 2584)
+++ source	2008-12-25 08:47:15 UTC (rev 2585)
@@ -14766,22 +14766,17 @@
 <p>Raymond woke with a start as the fire alarm rang out.</p></pre>
   </div>
 
-  <p>The <code>i</code> element should be used as a last resort when
-  no other element is more appropriate. In particular, citations
-  should use the <code>cite</code> element, defining instances of
-  terms should use the <code>dfn</code> element, stress emphasis
-  should use the <code>em</code> element, importance should be denoted
-  with the <code>strong</code> element, quotes should be marked up
-  with the <code>q</code> element, and small print should use the
-  <code>small</code> element.</p>
-
   <p>Authors are encouraged to use the <code
   title="attr-class">class</code> attribute on the <code>i</code>
   element to identify why the element is being used, so that if the
   style of a particular use (e.g. dream sequences as opposed to
   taxonomic terms) is to be changed at a later date, the author
   doesn't have to go through the entire document (or series of related
-  documents) annotating each use.</p>
+  documents) annotating each use. Similarly, authors are encouraged to
+  consider whether other elements might be more applicable than the
+  <code>i</code> element, for instance the <code>em</code> element for
+  marking up stress emphasis, or the <code>dfn</code> element to mark
+  up the defining instance of a term.</p>
 
   <p class="note">Style sheets can be used to format <code>i</code>
   elements, just like any other element can be restyled. Thus, it is