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

html5/spec Overview.html,1.1284,1.1285

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 23 Aug 2008 10:00:54 +0000
To: public-html-commits@w3.org
Message-Id: <E1KWpvS-0007RA-Vo@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv28573

Modified Files:
	Overview.html 
Log Message:
Make the broad strokes more obvious in the alt='' section. Also, split the 'sliced image' section in two. (credit: bb) (whatwg r2112)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1284
retrieving revision 1.1285
diff -u -d -r1.1284 -r1.1285
--- Overview.html	23 Aug 2008 09:47:52 -0000	1.1284
+++ Overview.html	23 Aug 2008 10:00:52 -0000	1.1285
@@ -812,19 +812,22 @@
             still specific to the surrounding content</a>
 
            <li><a href="#a-group"><span class=secno>4.7.2.1.7. </span>A group
-            of images that form a single larger picture</a>
+            of images that form a single larger picture with no links</a>
 
-           <li><a href="#a-key"><span class=secno>4.7.2.1.8. </span>A key
+           <li><a href="#a-group0"><span class=secno>4.7.2.1.8. </span>A
+            group of images that form a single larger picture with links</a>
+
+           <li><a href="#a-key"><span class=secno>4.7.2.1.9. </span>A key
             part of the content</a>
 
-           <li><a href="#an-image"><span class=secno>4.7.2.1.9. </span>An
+           <li><a href="#an-image"><span class=secno>4.7.2.1.10. </span>An
             image not intended for the user</a>
 
-           <li><a href="#an-image0"><span class=secno>4.7.2.1.10. </span>An
+           <li><a href="#an-image0"><span class=secno>4.7.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><a href="#general"><span class=secno>4.7.2.1.11.
+           <li><a href="#general"><span class=secno>4.7.2.1.12.
             </span>General guidelines</a>
           </ul>
         </ul>
@@ -16482,6 +16485,9 @@
    the image specified in the <code title=attr-img-src><a
    href="#src">src</a></code> attribute.
 
+  <p>It is important to realize that the alternative text is a
+   <em>replacement</em> for the image, not a description of the image.
+
   <div class=example>
    <p>In the following example we have <a
     href="images/parsing-model-overview.png">a flowchart</a> in image form,
@@ -16525,9 +16531,6 @@
 &lt;/p></pre>
   </div>
 
-  <p>It is important to realize that the alternative text is a
-   <em>replacement</em> for the image, not a description of the image.
-
   <h6 id=a-short><span class=secno>4.7.2.1.3. </span>A short phrase or label
    with an alternative graphical representation: icons, logos</h6>
 
@@ -16680,6 +16683,10 @@
    title=attr-img-alt><a href="#alt0">alt</a></code> attribute must be
    present but its value must be the empty string.
 
+  <p>In general, an image falls into this category if removing the image
+   doesn't make the page any less useful, but including the image makes it a
+   lot easier for users of visual browsers to understand the concept.
+
   <div class=example>
    <p>A flowchart that repeats the previous paragraph in graphical form:</p>
 
@@ -16746,17 +16753,19 @@
 <strong>&lt;p>&lt;img src="rendering-mode-pie-chart.png" alt="">&lt;/p></strong></pre>
   </div>
 
-  <p>In general, an image falls into this category if removing the image
-   doesn't make the page any less useful, but including the image makes it a
-   lot easier for users of visual browsers to understand the concept.
-
   <h6 id=a-purely><span class=secno>4.7.2.1.6. </span>A purely decorative
    image that doesn't add any information but is still specific to the
    surrounding content</h6>
 
-  <p>In some cases, the image isn't discussed by the surrounding text, but it
-   has some relevance. Such images are decorative, but still form part of the
-   content. In these cases, the <code title=attr-img-alt><a
+  <p>In general, if an image is decorative but isn't especially
+   page-specific, for example an image that forms part of a site-wide design
+   scheme, the image should be specified in the site's CSS, not in the markup
+   of the document.
+
+  <p>However, a decorative image that isn't discussed by the surrounding text
+   still has some relevance can be included in a page using the <code><a
+   href="#img">img</a></code> element. Such images are decorative, but still
+   form part of the content. In these cases, the <code title=attr-img-alt><a
    href="#alt0">alt</a></code> attribute must be present but its value must
    be the empty string.
 
@@ -16781,13 +16790,8 @@
 The island of Shalott.&lt;/p></pre>
   </div>
 
-  <p>In general, if an image is decorative but isn't especially
-   page-specific, for example an image that forms part of a site-wide design
-   scheme, the image should be specified in the site's CSS, not in the markup
-   of the document.
-
   <h6 id=a-group><span class=secno>4.7.2.1.7. </span>A group of images that
-   form a single larger picture</h6>
+   form a single larger picture with no links</h6>
 
   <p>When a picture has been sliced into smaller image files that are then
    displayed together to form the complete picture again, one of the images
@@ -16819,9 +16823,15 @@
   >&lt;img src="0" alt=""></strong>&lt;/meter>&lt;/p></pre>
   </div>
 
-  <p>If any of the components of the sliced picture are the sole contents of
-   links, then instead one image per link must have alternative text
-   representing the purpose of the link.
+  <h6 id=a-group0><span class=secno>4.7.2.1.8. </span>A group of images that
+   form a single larger picture with links</h6>
+
+  <p>Generally, <a href="#image2" title="image map">image maps</a> should be
+   used instead of slicing an image for links.
+
+  <p>However, if an image is indeed sliced and any of the components of the
+   sliced picture are the sole contents of links, then one image per link
+   must have alternative text representing the purpose of the link.
 
   <div class=example>
    <p>In the following example, a picture representing the flying spaghetti
@@ -16833,13 +16843,11 @@
 &lt;p>You come across a flying spaghetti monster. Which side of His
 Noodliness do you wish to reach out for?&lt;/p>
 <strong>&lt;p>&lt;a href="?go=left" >&lt;img src="fsm-left.png"  alt="Left side. ">&lt;/a
+  >&lt;img src="fsm-middle.png"  alt=""
   >&lt;a href="?go=right">&lt;img src="fsm-right.png" alt="Right side.">&lt;/a>&lt;/p></strong></pre>
   </div>
 
-  <p>Generally, <a href="#image2" title="image map">image maps</a> should be
-   used instead of slicing an image for links.
-
-  <h6 id=a-key><span class=secno>4.7.2.1.8. </span>A key part of the content</h6>
+  <h6 id=a-key><span class=secno>4.7.2.1.9. </span>A key part of the content</h6>
 
   <p>In some cases, the image is a critical part of the content. This could
    be the case, for instance, on a page that is part of a photo gallery. The
@@ -17060,18 +17068,18 @@
      be made available, e.g. on automated image gallery sites.</p>
   </dl>
 
-  <h6 id=an-image><span class=secno>4.7.2.1.9. </span>An image not intended
+  <h6 id=an-image><span class=secno>4.7.2.1.10. </span>An image not intended
    for the user</h6>
 
+  <p>Generally authors should avoid using <code><a href="#img">img</a></code>
+   elements for purposes other than showing images.
+
   <p>If an <code><a href="#img">img</a></code> element is being used for
    purposes other than showing an image, e.g. as part of a service to count
    page views, then the <code title=attr-img-alt><a
    href="#alt0">alt</a></code> attribute must be the empty string.
 
-  <p>Generally authors should avoid using <code><a href="#img">img</a></code>
-   elements for purposes other than showing images.
-
-  <h6 id=an-image0><span class=secno>4.7.2.1.10. </span>An image in an e-mail
+  <h6 id=an-image0><span class=secno>4.7.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</h6>
 
@@ -17085,7 +17093,7 @@
    images, or should the e-mail be forwarded on to other users whose
    abilities might not include easily seeing images.
 
-  <h6 id=general><span class=secno>4.7.2.1.11. </span>General guidelines</h6>
+  <h6 id=general><span class=secno>4.7.2.1.12. </span>General guidelines</h6>
 
   <p>The most general rule for writing alternative text is that the intent is
    that replacing every image with the text of its <code
Received on Saturday, 23 August 2008 10:01:29 GMT

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