- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 23 Aug 2008 09:47:55 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27267
Modified Files:
Overview.html
Log Message:
Change from 'anti-patterns' to 'general guidelines' so as to remain positive. (whatwg r2111)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1283
retrieving revision 1.1284
diff -u -d -r1.1283 -r1.1284
--- Overview.html 23 Aug 2008 09:36:34 -0000 1.1283
+++ Overview.html 23 Aug 2008 09:47:52 -0000 1.1284
@@ -824,8 +824,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>
@@ -17085,18 +17085,25 @@
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>
Received on Saturday, 23 August 2008 09:48:34 UTC