[html5] r2111 - [e] (0) Change from 'anti-patterns' to 'general guidelines' so as to remain positive.

[whatwg at whatwg.org]

Author: ianh
Date: 2008-08-23 02:48:06 -0700 (Sat, 23 Aug 2008)
New Revision: 2111

Modified:
   index
   source
Log:
[e] (0) Change from 'anti-patterns' to 'general guidelines' so as to remain positive.

Modified: index
===================================================================
--- index	2008-08-23 09:36:47 UTC (rev 2110)
+++ index	2008-08-23 09:48:06 UTC (rev 2111)
@@ -816,8 +816,8 @@
             image in an e-mail or document intended for a specific person who
             is known to be able to view images</a>
 
-           <li><a href="#anti-patterns"><span class=secno>4.7.2.1.11.
-            </span>Anti-patterns</a>
+           <li><a href="#general"><span class=secno>4.7.2.1.11.
+            </span>General guidelines</a>
           </ul>
         </ul>
 
@@ -17077,19 +17077,26 @@
    images, or should the e-mail be forwarded on to other users whose
    abilities might not include easily seeing images.
 
-  <h6 id=anti-patterns><span class=secno>4.7.2.1.11. </span>Anti-patterns</h6>
+  <h6 id=general><span class=secno>4.7.2.1.11. </span>General guidelines</h6>
 
-  <p>The <code title=attr-img-alt><a href="#alt0">alt</a></code> attribute's
-   value should never contain text that could be considered the image's
-   <em><a href="#caption0">caption</a></em>, <em><a
-   href="#title1">title</a></em>, or <em><a href="#legend">legend</a></em>.
-   It is supposed to contain replacement text that could be used by users
-   <em>instead</em> of the image; it is not meant to supplement the image.
-   The <code title=attr-title><a href="#title">title</a></code> attribute can
-   be used for supplemental information.
+  <p>The most general rule for writing alternative text is that the intent is
+   that replacing every image with the text of its <code
+   title=attr-img-alt><a href="#alt0">alt</a></code> attribute not change the
+   meaning of the page.
 
-  <p>
+  <p>So, in general, alternative text can be written by considering what one
+   would have written had one not been able to include the image.
 
+  <p>A corollary to this is that the <code title=attr-img-alt><a
+   href="#alt0">alt</a></code> attribute's value should never contain text
+   that could be considered the image's <em><a
+   href="#caption0">caption</a></em>, <em><a href="#title1">title</a></em>,
+   or <em><a href="#legend">legend</a></em>. It is supposed to contain
+   replacement text that could be used by users <em>instead</em> of the
+   image; it is not meant to supplement the image. The <code
+   title=attr-title><a href="#title">title</a></code> attribute can be used
+   for supplemental information.
+
   <h4 id=the-iframe><span class=secno>4.7.3 </span>The <dfn
    id=iframe><code>iframe</code></dfn> element</h4>
 

Modified: source
===================================================================
--- source	2008-08-23 09:36:47 UTC (rev 2110)
+++ source	2008-08-23 09:48:06 UTC (rev 2111)
@@ -14660,20 +14660,30 @@
 
 
 
-  <h6>Anti-patterns</h6>
+  <h6>General guidelines</h6>
 
-  <p>The <code title="attr-img-alt">alt</code> attribute's value
-  should never contain text that could be considered the image's
-  <em>caption</em>, <em>title</em>, or <em>legend</em>. It is supposed
-  to contain replacement text that could be used by users
-  <em>instead</em> of the image; it is not meant to supplement the
-  image. The <code title="attr-title">title</code> attribute can be
-  used for supplemental information.<p>
+  <p>The most general rule for writing alternative text is that the
+  intent is that replacing every image with the text of its <code
+  title="attr-img-alt">alt</code> attribute not change the meaning of
+  the page.</p>
 
+  <p>So, in general, alternative text can be written by considering
+  what one would have written had one not been able to include the
+  image.</p>
 
+  <p>A corollary to this is that the <code
+  title="attr-img-alt">alt</code> attribute's value should never
+  contain text that could be considered the image's <em>caption</em>,
+  <em>title</em>, or <em>legend</em>. It is supposed to contain
+  replacement text that could be used by users <em>instead</em> of the
+  image; it is not meant to supplement the image. The <code
+  title="attr-title">title</code> attribute can be used for
+  supplemental information.</p>
 
 
 
+
+
   <h4>The <dfn><code>iframe</code></dfn> element</h4>
 
   <dl class="element">