Skip to content

Commit

Permalink
Editorial changes to 3
Browse files Browse the repository at this point in the history
Addressed typos and made concise editorial changes for clarity
  • Loading branch information
jenstrickland authored Jan 14, 2025
1 parent 174f46c commit 5b3f53a
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -125,19 +125,19 @@ <h2>Real-Time Co-editing</h2>
<section id="annotations">
<h2>Annotations</h2>
<ul>
<li><strong>User Need 6:</strong> An assistive technology user needs to be informed of the presence of annotations along with the specific part of the content being annotated, such as words, sentences or paragraphs. This also applies to lines of code in a software development project.</li>
<li><strong>REQ 6:</strong> Ensure that information about annotations is conveyed to assistive technologies, together with the boundaries of the text to which the annotation applies, along with any metadata associated with the annotation, and any comment text.</li>
<li><strong>User Need 6:</strong> An assistive technology user needs to be informed of the presence of annotations along with the specific part of the content being annotated, such as words, sentences, or paragraphs. This also applies to lines of code in a software development project.</li>
<li><strong>REQ 6:</strong> Ensure that information about annotations is conveyed to assistive technologies, together with the boundaries of the text to which the annotation applies, along with any metadata associated with the annotation and any comment text.</li>
</ul>
<p class="note">See <cite>Web Content Accessibility Guidelines (WCAG) 2.2</cite> [[wcag22]], success criterion 1.3.1.</p>
<ul>
<li><strong>User Need 7:</strong> Assistive technology users need to be able to review content without being overwhelmed or distracted by information about annotations.</li>
<li><strong>REQ 7:</strong> Provide a mode of operation in which information about annotations is suppressed. This mode might be activated by an application setting, such as a toggle switch controlling the presence or absence of annotations.</li>
<li><strong>User Need 8:</strong> An assistive technology user needs to be able to navigate between annotations (from previous to next) and to obtain a navigable list of annotations (e.g., a list of comments in a word processor document or on a Web page), in order to read and respond to annotations efficiently.</li>
<li><strong>REQ 8:</strong> Provide navigation and content viewing functions and a means of obtaining a navigable list of all the annotations associated with the content.</li>
<li><strong>User Need 9:</strong> Assistive technology users need to be able to control the amount of information presented about annotations to prevent becoming overwhelmed while they are reading, navigating and editing content.</li>
<li><strong>REQ 9:</strong> Provide options for the user to limit the amount of detail presented as each annotation is encountered. For example, it should be possible to suppress presentation of metadata, or replies to comments, or to alert the user only to the presence of the annotation without presenting the metadata or comment text.</li>
<li><strong>User Need 9:</strong> Assistive technology users need to be able to control the amount of information presented about annotations to prevent becoming overwhelmed while they are reading, navigating, and editing content.</li>
<li><strong>REQ 9:</strong> Provide options for the user to limit the amount of detail presented as each annotation is encountered. For example, it should be possible to suppress presentation of metadata or replies to comments, or to alert the user only to the presence of the annotation without presenting the metadata or comment text.</li>
<li><strong>User Need 10:</strong> Assistive technology users and users with learning or cognitive disabilities sometimes need support in understanding and navigating annotations that represent comments organized as <em>threads</em> of conversation.</li>
<li><strong>REQ 10A:</strong> Ensure that the structure of comment threads is unambiguously presented in the user interface, both via visual cues such as icons and color changes, and to assistive technologies.</li>
<li><strong>REQ 10A:</strong> Ensure that the structure of comment threads is unambiguously presented in the user interface, both via visual cues such as icons and color changes as well as programmatically, and to assistive technologies.</li>
<li><strong>REQ 10B:</strong> Enable threads to be expanded or collapsed by the user, and ensure the expanded or collapsed state is disclosed to assistive technologies.</li>
</ul>
<p class="note">REQ 8 may be valuable to users in general, and it should be considered for inclusion as a feature of collaboration tools themselves.</p>
Expand Down

0 comments on commit 5b3f53a

Please sign in to comment.