added a code example for linking to document fragments and clarified how that should happen
authorMark Sadecki <mark@w3.org>
Sun, 08 Jun 2014 17:28:13 -0400
changeset 93 30ec78eee32b
parent 92 8bf116468476
child 94 64a9e65cbab3
added a code example for linking to document fragments and clarified how that should happen
longdesc1/longdesc.html
--- 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">
+
+&lt;!-- Image with description that is only part of target document --&gt;
+&lt;img src=&quot;foo.png&quot; alt=&quot;Example image&quot; longdesc=&quot;example.html#desc2&quot;&gt;
+
+&lt;!-- Target document --&gt;
+&lt;section id=&quot;desc2&quot;&gt;
+  &lt;h2&gt;Image foo.png&lt;/2&gt;
+  &lt;p&gt;Description of the image...&lt;/p&gt;
+&lt;/section&gt;
+          </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