[html5] r2478 - [] (0) Guidance on writing alt='' text for markup generators.

[whatwg at whatwg.org]

Author: ianh
Date: 2008-11-29 14:57:14 -0800 (Sat, 29 Nov 2008)
New Revision: 2478

Modified:
   index
   source
Log:
[] (0) Guidance on writing alt='' text for markup generators.

Modified: index
===================================================================
--- index	2008-11-29 22:39:30 UTC (rev 2477)
+++ index	2008-11-29 22:57:14 UTC (rev 2478)
@@ -423,7 +423,8 @@
          <li><a href=#a-key-part-of-the-content><span class=secno>4.8.2.1.9 </span>A key part of the content</a></li>
          <li><a href=#an-image-not-intended-for-the-user><span class=secno>4.8.2.1.10 </span>An image not intended for the user</a></li>
          <li><a href=#an-image-in-an-e-mail-or-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images><span class=secno>4.8.2.1.11 </span>An image in an e-mail or document intended for a specific person who is known to be able to view images</a></li>
-         <li><a href=#general-guidelines><span class=secno>4.8.2.1.12 </span>General guidelines</a></ol></ol></li>
+         <li><a href=#general-guidelines><span class=secno>4.8.2.1.12 </span>General guidelines</a></li>
+         <li><a href=#guidance-for-markup-generators><span class=secno>4.8.2.1.13 </span>Guidance for markup generators</a></ol></ol></li>
      <li><a href=#the-iframe-element><span class=secno>4.8.3 </span>The <code>iframe</code> element</a></li>
      <li><a href=#the-embed-element><span class=secno>4.8.4 </span>The <code>embed</code> element</a></li>
      <li><a href=#the-object-element><span class=secno>4.8.5 </span>The <code>object</code> element</a></li>
@@ -15322,8 +15323,26 @@
 
 
 
+  <h6 id=guidance-for-markup-generators><span class=secno>4.8.2.1.13 </span>Guidance for markup generators</h6>
 
+  <p>Markup generators (such as WYSIWYG authoring tools) should,
+  wherever possible, obtain alternative text from their
+  users. However, it is recognised that in many cases, this will not
+  be possible.</p>
 
+  <p>As a last resort, implementors should either set the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute to the empty string, under
+  the assumption that the image is a purely decorative image that
+  doesn't add any information but is still specific to the surrounding
+  content, or omit the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute
+  altogther, under the assumption that the image is a key part of the
+  content.</p>
+
+  <p>Markup generators should generally avoid using the image's file
+  name as the alternative text.</p>
+
+
+
+
   <h4 id=the-iframe-element><span class=secno>4.8.3 </span>The <dfn><code>iframe</code></dfn> element</h4>
 
   <dl class=element><dt>Categories</dt>

Modified: source
===================================================================
--- source	2008-11-29 22:39:30 UTC (rev 2477)
+++ source	2008-11-29 22:57:14 UTC (rev 2478)
@@ -16358,8 +16358,27 @@
 
 
 
+  <h6>Guidance for markup generators</h6>
 
+  <p>Markup generators (such as WYSIWYG authoring tools) should,
+  wherever possible, obtain alternative text from their
+  users. However, it is recognised that in many cases, this will not
+  be possible.</p>
 
+  <p>As a last resort, implementors should either set the <code
+  title="attr-img-alt">alt</code> attribute to the empty string, under
+  the assumption that the image is a purely decorative image that
+  doesn't add any information but is still specific to the surrounding
+  content, or omit the <code title="attr-img-alt">alt</code> attribute
+  altogther, under the assumption that the image is a key part of the
+  content.</p>
+
+  <p>Markup generators should generally avoid using the image's file
+  name as the alternative text.</p>
+
+
+
+
   <h4>The <dfn><code>iframe</code></dfn> element</h4>
 
   <dl class="element">