added a code example for linking to document fragments and clarified how that should happen
--- a/longdesc1/longdesc.html Sun Jun 08 17:26:53 2014 -0400
+++ b/longdesc1/longdesc.html Sun Jun 08 17:28:13 2014 -0400
@@ -664,8 +664,23 @@
</div>
<h4 id="authors">3.0.2 Authors</h4>
<p>When a description is only part of the target document, authors
- <em class="rfc2119">should</em> link to a fragment link in the target document
- (e.g. <code>longdesc="example.html#description"</code>).</p>
+ <em class="rfc2119">should</em> link to a container element in the target
+ document that contains the entire description.</p>
+ <div class="example" role="region" aria-label="example">
+ <pre>
+<span class="informative">Example: (Informative)</span>
+<code class="language-markup">
+
+<!-- Image with description that is only part of target document -->
+<img src="foo.png" alt="Example image" longdesc="example.html#desc2">
+
+<!-- Target document -->
+<section id="desc2">
+ <h2>Image foo.png</2>
+ <p>Description of the image...</p>
+</section>
+ </code></pre>
+ </div>
<div class="note" role="region" aria-label="informative">
<p><em>This section is informative</em></p>
<p>Best practices for full descriptions of images are beyond the scope