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

git-svn-id: http://svn.whatwg.org/webapps@2478 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Nov 29, 2008 · 6ff8350 · 6ff8350
1 parent f2151b0
commit 6ff8350
Show file tree

Hide file tree

Showing 2 changed files with 39 additions and 1 deletion.
diff --git a/index b/index
@@ -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,6 +15323,24 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
 
 
 
+  <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>

diff --git a/source b/source
@@ -16358,6 +16358,25 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
 
 
 
+  <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>