[Bug 23373] New: example given is incorrect and promotes poor quality link text

https://www.w3.org/Bugs/Public/show_bug.cgi?id=23373

            Bug ID: 23373
           Summary: example given is incorrect and promotes poor quality
                    link text
           Product: HTML WG
           Version: unspecified
          Hardware: PC
               URL: http://www.w3.org/html/wg/drafts/html/master/links.htm
                    l#link-type-bookmark
                OS: All
            Status: NEW
          Keywords: a11y
          Severity: normal
          Priority: P2
         Component: HTML5 spec
          Assignee: faulkner.steve@gmail.com
          Reporter: mark@w3.org
        QA Contact: public-html-bugzilla@w3.org
                CC: mike@w3.org, public-html-admin@w3.org,
                    public-html-wg-issue-tracking@w3.org

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

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Thursday, 26 September 2013 18:39:20 UTC