[html5] r1008 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2007-08-15 03:16:08 -0700 (Wed, 15 Aug 2007)
New Revision: 1008

Modified:
   index
   source
Log:
[] (1) New alt='' example.

Modified: index
===================================================================
--- index	2007-08-15 09:25:54 UTC (rev 1007)
+++ index	2007-08-15 10:16:08 UTC (rev 1008)
@@ -12050,6 +12050,35 @@
 document.write(), passes data to the Tokeniser."></strong></p></pre>
     </div>
 
+    <div class=example>
+     <p>Here's another example, showing a good solution and a bad solution to
+      the problem of including an image in a description.</p>
+
+     <p>First, here's the good solution. This sample shows how the
+      alternative text should just be what you would have put in the prose if
+      the image had never existed.</p>
+
+     <pre><!-- This is the correct way to do things. -->
+<p>
+ You are standing in an open field west of a house.
+ <strong><img src="house.jpeg" alt="The house is white, with a boarded front door."></strong>
+ There is a small mailbox here.
+</p></pre>
+
+     <p>Second, here's the bad solution. In this incorrect way of doing
+      things, the alternative text is simply a description of the image,
+      instead of a textual replacement for the image. It's bad because when
+      the image isn't shown, the text doesn't flow as well as in the first
+      example.</p>
+
+     <pre><!-- <em>This is the wrong way to do things.</em> -->
+<p>
+ You are standing in an open field west of a house.
+ <img src="house.jpeg" alt="A white house, with a boarded front door.">
+ There is a small mailbox here.
+</p></pre>
+    </div>
+
     <p>It is important to realise that the alternative text is a
      <em>replacement</em> for the image, not a description of the image.</p>
 

Modified: source
===================================================================
--- source	2007-08-15 09:25:54 UTC (rev 1007)
+++ source	2007-08-15 10:16:08 UTC (rev 1008)
@@ -10027,6 +10027,38 @@
 
     </div>
 
+    <div class="example">
+
+     <p>Here's another example, showing a good solution and a bad
+     solution to the problem of including an image in a
+     description.</p>
+
+     <p>First, here's the good solution. This sample shows how the
+     alternative text should just be what you would have put in the
+     prose if the image had never existed.</p>
+
+     <pre><!-- This is the correct way to do things. -->
+<p>
+ You are standing in an open field west of a house.
+ <strong><img src="house.jpeg" alt="The house is white, with a boarded front door."></strong>
+ There is a small mailbox here.
+</p></pre>
+
+     <p>Second, here's the bad solution. In this incorrect way of
+     doing things, the alternative text is simply a description of the
+     image, instead of a textual replacement for the image. It's bad
+     because when the image isn't shown, the text doesn't flow as well
+     as in the first example.</p>
+
+     <pre><!-- <em>This is the wrong way to do things.</em> -->
+<p>
+ You are standing in an open field west of a house.
+ <img src="house.jpeg" alt="A white house, with a boarded front door.">
+ There is a small mailbox here.
+</p></pre>
+
+    </div>
+
     <p>It is important to realise that the alternative text is a
     <em>replacement</em> for the image, not a description of the
     image.</p>