This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 23373 - example given is incorrect and promotes poor quality link text
Summary: example given is incorrect and promotes poor quality link text
Status: RESOLVED FIXED
Alias: None
Product: HTML WG
Classification: Unclassified
Component: HTML5 spec (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: steve faulkner
QA Contact: HTML WG Bugzilla archive list
URL: http://www.w3.org/html/wg/drafts/html...
Whiteboard:
Keywords: a11y
Depends on:
Blocks:
 
Reported: 2013-09-26 18:39 UTC by Mark Sadecki
Modified: 2015-06-05 15:05 UTC (History)
3 users (show)

See Also:


Attachments

Description Mark Sadecki 2013-09-26 18:39:18 UTC
The Code example in the referenced section [1] would be more clear if the href values used in the permalinks actually pointed to the sections of the document in the example (#a instead of a.html). Also, linking simply the word "This" three times promotes poor quality link text which is a failure of WCAG SC 2.4.4 and 2.4.9 Link Context [2]

Suggested text:

<h1>Example of permalinks</h1>
  <div id="a">
   <h2>First example</h2>
   <p><a href="#a" rel="bookmark">This permalink applies to
   only the content from the first H2 to the second H2</a>. The DIV isn't
   exactly that section, but it roughly corresponds to it.</p>
  </div>
  <h2>Second example</h2>
  <article id="b">
   <p><a href="#b" rel="bookmark">This permalink applies to
   the outer ARTICLE element</a>(which could be, e.g., a blog post).</p>
   <article id="c">
    <p><a href="#c" rel="bookmark">This permalink applies to
    the inner ARTICLE element</a>(which could be, e.g., a blog comment).</p>
   </article>
  </article>

[1] http://www.w3.org/html/wg/drafts/html/master/links.html#link-type-bookmark
[2] http://www.w3.org/TR/2008/REC-WCAG20-20081211/#navigation-mechanisms-refs
Comment 1 steve faulkner 2014-02-17 09:56:42 UTC
(In reply to Mark Sadecki from comment #0)
> The Code example in the referenced section [1] would be more clear if the
> href values used in the permalinks actually pointed to the sections of the
> document in the example (#a instead of a.html). Also, linking simply the
> word "This" three times promotes poor quality link text which is a failure
> of WCAG SC 2.4.4 and 2.4.9 Link Context [2]
> 
> Suggested text:
> 
> <h1>Example of permalinks</h1>
>   <div id="a">
>    <h2>First example</h2>
>    <p><a href="#a" rel="bookmark">This permalink applies to
>    only the content from the first H2 to the second H2</a>. The DIV isn't
>    exactly that section, but it roughly corresponds to it.</p>
>   </div>
>   <h2>Second example</h2>
>   <article id="b">
>    <p><a href="#b" rel="bookmark">This permalink applies to
>    the outer ARTICLE element</a>(which could be, e.g., a blog post).</p>
>    <article id="c">
>     <p><a href="#c" rel="bookmark">This permalink applies to
>     the inner ARTICLE element</a>(which could be, e.g., a blog comment).</p>
>    </article>
>   </article>
> 
> [1]
> http://www.w3.org/html/wg/drafts/html/master/links.html#link-type-bookmark
> [2] http://www.w3.org/TR/2008/REC-WCAG20-20081211/#navigation-mechanisms-refs

Hi Mark, looks like the link text has been fixed [1], unsure whether the href content is problematic, it's not really relevant to the example no?

[1] http://www.w3.org/html/wg/drafts/html/master/links.html#link-type-bookmark