Skip to content

Commit 512b69d

Browse files
authored
Merge pull request #83 from daisy/avneeshsingh-patch-2
Improved readability of first paragraph of recommended technique
2 parents 94b9528 + b7cc781 commit 512b69d

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

best-practices/extended-desc/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ <h2>Recommendations</h2>
5959
<section id="technique1">
6060
<h3>Recommended technique: Extended description in a separate HTML file with hyperlink</h3>
6161

62-
<p>This technique provides extended descriptions in separate HTML file(s) (e.g. and appendix at the end of the e-book, possibly a file containing extended descriptions for each chapter of the publication or even a file for each image) from the main content, with a hyperlink below the image to the description and a back link to return to the original reading position.</p>
62+
<p>This technique provides extended descriptions in separate HTML file(s) (e.g. and appendix at the end of the e-book, a file containing extended descriptions for each chapter of the publication or even a file for each image). A hyperlink placed below the image in the main content links to the description in the separate file. And a back link placed in the description returns the user to the original reading position in the main content.</p>
6363

6464
<p class="note">This technique is recommended over the use of HTML <code>details</code> element (see <a href="#technique3">Deprecated technique</a>) as it provides better support across reading systems and reduces cognitive load for users.</p>
6565

0 commit comments

Comments
 (0)