Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

in brief material for WCAG 2.0 success criteria #3219

Merged
merged 31 commits into from
Aug 1, 2023
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
21f46ab
in brief material for A and AA
mbgower May 29, 2023
4ebf8d6
Remove key beneficiaries from 2.0 A/AA
mbgower Jun 13, 2023
d62f329
Added AAA requirements
mbgower Jun 13, 2023
f5de52f
Update understanding/20/abbreviations.html
mbgower Jun 13, 2023
cfad43a
Update understanding/20/error-prevention-legal-financial-data.html
mbgower Jun 13, 2023
fe5966a
Update understanding/20/error-prevention-legal-financial-data.html
mbgower Jun 13, 2023
122fcb5
Update understanding/20/error-prevention-all.html
mbgower Jun 13, 2023
896e6bd
Update understanding/20/error-prevention-legal-financial-data.html
mbgower Jun 13, 2023
ee7ef18
Update understanding/20/keyboard-no-exception.html
mbgower Jun 13, 2023
db29bb3
Update understanding/20/language-of-page.html
mbgower Jun 15, 2023
1d3a9f1
Update understanding/20/language-of-parts.html
mbgower Jun 15, 2023
dd00422
Update understanding/20/keyboard.html
mbgower Jun 15, 2023
9734ce3
Update understanding/20/keyboard.html
mbgower Jun 15, 2023
a00d650
resolving conflicts
mbgower Jun 15, 2023
b3d2739
Update accessible-authentication-minimum.html
mbgower Jun 15, 2023
cf98f2e
Update understanding/20/error-identification.html
mbgower Jun 23, 2023
1935824
Update understanding/20/keyboard.html
mbgower Jun 23, 2023
cafed04
Update understanding/20/link-purpose-in-context.html
mbgower Jun 23, 2023
837d245
Update understanding/20/name-role-value.html
mbgower Jun 23, 2023
551d842
Update understanding/20/help.html
patrickhlauke Jun 26, 2023
16499bc
Update understanding/20/focus-order.html
mbgower Jun 27, 2023
841ed90
Update understanding/20/unusual-words.html
mbgower Jun 27, 2023
97fe7a0
Update understanding/20/contrast-minimum.html
mbgower Jun 27, 2023
acf2777
Update understanding/20/extended-audio-description-prerecorded.html
mbgower Jun 30, 2023
ca48061
Update understanding/20/images-of-text-no-exception.html
alastc Jul 7, 2023
9600246
Apply suggestions from AGWG review
mbgower Jul 7, 2023
2373729
Update understanding/20/images-of-text-no-exception.html
mbgower Jul 14, 2023
6cd61ae
Update understanding/20/images-of-text.html
mbgower Jul 14, 2023
4ddb242
Update understanding/20/low-or-no-background-audio.html
mbgower Jul 14, 2023
0e2af8f
attempt to resolving conflict
mbgower Jul 31, 2023
103d7cb
Apply suggestions from code review
mbgower Aug 1, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 1 addition & 1 deletion understanding/20/audio-description-prerecorded.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Audio Description (Prerecorded)</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Videos can be played with audio descriptions</dd>
<dt>Author task</dt><dd>Provide a synchronized description of the visual content in videos</dd>
<dt>Author task</dt><dd>Provide a synchronized spoken description of the visual content in videos</dd>

</dl>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Audio-only and Video-only (Prerecorded)</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Audio and video-only content can be understood by more people</dd>
<dt>Author task</dt><dd>Provide an alternative to content perceivable with only one sense</dd>
<dt>Author task</dt><dd>Provide an alternative when content is perceivable with only one sense</dd>

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/captions-live.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Captions (Live)</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Live videos have captions</dd>
<dt>Author task</dt><dd>Provide captions for audio content in real-time videos</dd>
<dt>Author task</dt><dd>Provide synchronized text for audio content in real-time videos</dd>

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/captions-prerecorded.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Captions (Prerecorded)</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Videos can be played with captions</dd>
<dt>Author task</dt><dd>Provide captions for audio content in existing videos</dd>
<dt>Author task</dt><dd>Provide synchronized text for audio content in existing videos</dd>

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/error-prevention-all.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Error Prevention (All)</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can avoid submitting incorrect information</dd>
<dt>Author task</dt><dd>Provide ways for users to confirm, correct, or reverse all submissions</dd>
<dt>Author task</dt><dd>Provide ways for users to confirm, correct, or reverse any submissions</dd>
</dl>

</section>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ <h1>Understanding Extended Audio Description (Prerecorded)</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Videos can be played with more detailed audio descriptions</dd>
<dt>Author task</dt><dd>Provide extended descriptions of the visual content in videos</dd>
<dt>Author task</dt><dd>Provide extended spoken descriptions of the visual content in videos</dd>
</dl>

</section>
Expand Down
2 changes: 1 addition & 1 deletion understanding/20/meaningful-sequence.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Meaningful Sequence</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>The order of content can be understood by more people</dd>
<dt>Author task</dt><dd>Properly use code to preserve meaningful content order</dd>
<dt>Author task</dt><dd>Use code to preserve meaningful content order</dd>

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/multiple-ways.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ <h1>Understanding Multiple Ways</h1>
<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can locate content in multiple ways</dd>
<dt>Objective</dt><dd>Users can get to content in multiple ways</dd>
<dt>Author task</dt><dd>Provide at least two options for reaching the same content</dd>

</dl>
Expand Down
2 changes: 1 addition & 1 deletion understanding/20/name-role-value.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ <h1>Understanding Name, Role, Value</h1>
<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Authors implement components properly</dd>
<dt>Objective</dt><dd>People using Assistive Technology understand all components</dd>
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this needed? The AT needs to interpret the components properly so that the author's intent is conveyed to the user. However, when are people using AT ever required to even understand what a component is.

Copy link
Contributor Author

@mbgower mbgower Jul 10, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mgifford
It could come down to finding a better word than 'understand', but consider this scenario:

  1. when the author assigns the correct role, the AT identifies it as, say, a menu, and the user thinks "okay, I'm in a menu" She understands what the interaction is (and some ATs will tell her basic interaction keys).
  2. when the author assigns a name, the AT identifies it, and if the user is reliant on the AT presentation, she may think "Okay, this is the View menu, that's not the menu I want, so I'll proceed to the next one"
  3. when the author assigns the value or state, as the user advances, she hears 'View menu, closed', moves on to the Profile menu and might hear which profile is currently selected.

That's the intended outcome of 4.1.2, so arguably, the goal is about the user getting the information. This differs a bit from 4.1.1 Parsing, where it really is just about making sure the AT is able to understand/process the code, even if there's no discernible impact on the users these days (and the reason there's no real user benefit/effect is why 4.1.1 is being 'dropped').

<dt>Author task</dt><dd>Give components correct names, roles, states, and values</dd>

</dl>
Expand Down
2 changes: 1 addition & 1 deletion understanding/20/no-keyboard-trap.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding No Keyboard Trap</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Keyboard users don't get stuck</dd>
<dt>Author task</dt><dd>If users could get trapped, tell them how to proceed</dd>
<dt>Author task</dt><dd>Ensure users always know how to navigate away from components</dd>
alastc marked this conversation as resolved.
Show resolved Hide resolved

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/on-input.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding On Input</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Content can be operated more predictably</dd>
<dt>Author task</dt><dd>Forewarn users about changes of context based on user input</dd>
<dt>Author task</dt><dd>Forewarn users if their context will change based on their input</dd>

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/parsing.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ <h1>Understanding Parsing</h1>
<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Authors implement pages properly</dd>
<dt>Objective</dt><dd>Assistive Technology can properly present page content</dd>
<dt>Author task</dt><dd>Create web pages according to specifications</dd>

</dl>
Expand Down
2 changes: 1 addition & 1 deletion understanding/20/sensory-characteristics.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Sensory Characteristics</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Instructions are understandable by more people</dd>
<dt>Author task</dt><dd>Don't use descriptions reliant on using our five senses</dd>
<dt>Author task</dt><dd> Describe controls by name, not just by appearance or location</dd>

</dl>

Expand Down
2 changes: 1 addition & 1 deletion understanding/20/use-of-color.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h1>Understanding Use of Color</h1>
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Color is not the only way of distinguishing information</dd>
<dt>Author task</dt><dd>Use other things than just color to convey meaning</dd>
<dt>Author task</dt><dd>Use information in addition to color, such as shape or text, to convey meaning</dd>

</dl>

Expand Down