23373 2013-09-26 18:39:18 +0000 example given is incorrect and promotes poor quality link text 2015-06-05 15:05:47 +0000 1 1 1 Unclassified HTML WG HTML5 spec unspecified PC All RESOLVED FIXED http://www.w3.org/html/wg/drafts/html/master/links.html#link-type-bookmark a11y P2 normal --- 1 mark.sadecki+w3c faulkner.steve mike public-html-admin public-html-wg-issue-tracking public-html-bugzilla oldest_to_newest 93910 0 mark.sadecki+w3c 2013-09-26 18:39:18 +0000 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 100735 1 faulkner.steve 2014-02-17 09:56:42 +0000 (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