W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2008

html5/spec Overview.html,1.1283,1.1284

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 23 Aug 2008 09:47:55 +0000
To: public-html-commits@w3.org
Message-Id: <E1KWpit-000765-60@lionel-hutz.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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:58 GMT