Skip to content

Commit

Permalink
[e] (0) Change from 'anti-patterns' to 'general guidelines' so as to …
Browse files Browse the repository at this point in the history 
…remain positive.

git-svn-id: http://svn.whatwg.org/webapps@2111 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Aug 23, 2008
1 parent 0d0e8ce commit 7cdd4ba
Show file tree
Hide file tree
Showing 2 changed files with 40 additions and 23 deletions.
35 changes: 21 additions & 14 deletions index
View file
Expand Up @@ -816,8 +816,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>

Expand Down Expand Up @@ -17077,18 +17077,25 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
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>

<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>
<h6 id=general><span class=secno>4.7.2.1.11. </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
title=attr-img-alt><a href="#alt0">alt</a></code> attribute not change the
meaning of the page.

<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>
Expand Down
28 changes: 19 additions & 9 deletions source
View file
Expand Up @@ -14660,15 +14660,25 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>



<h6>Anti-patterns</h6>

<p>The <code title="attr-img-alt">alt</code> attribute's value
should never contain text that could be considered the image's
<em>caption</em>, <em>title</em>, or <em>legend</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">title</code> attribute can be
used for supplemental information.<p>
<h6>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
title="attr-img-alt">alt</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>

<p>A corollary to this is that the <code
title="attr-img-alt">alt</code> attribute's value should never
contain text that could be considered the image's <em>caption</em>,
<em>title</em>, or <em>legend</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">title</code> attribute can be used for
supplemental information.</p>



Expand Down

0 comments on commit 7cdd4ba

Please sign in to comment.