spec/Overview.html 1.1649 2478 Guidance on writing alt='' text for mark

Guidance on writing alt='' text for markup generators. (whatwg r2478)

4.8.2.1.13 Guidance for markup generators
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1649.html#guidance-for-markup-generators
4.8.2.1.12 General guidelines
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1649.html#general-guidelines
4.8.3 The iframe element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1649.html#the-iframe-element

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1648&r2=1.1649&f=h
http://html5.org/tools/web-apps-tracker?from=2477&to=2478

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1648
retrieving revision 1.1649
diff -u -d -r1.1648 -r1.1649
--- Overview.html 29 Nov 2008 22:39:34 -0000 1.1648
+++ Overview.html 29 Nov 2008 22:57:18 -0000 1.1649
@@ -361,7 +361,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>
@@ -12472,7 +12473,16 @@
   about what how you would read the page containing the image to
   someone over the phone, without mentioning that there is an image
   present. Whatever you say instead of the image is typically a good
-  start for writing the alternative text.<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>
+  start for writing the alternative text.<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>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>Markup generators should generally avoid using the image's file
+  name as the alternative text.<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>
    <dd><a href=#embedded-content-1>Embedded content</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href=#embedded-content-1>embedded content</a> is expected.</dd>

Received on Saturday, 29 November 2008 23:00:43 UTC