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 26 commits
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
8 changes: 8 additions & 0 deletions understanding/20/abbreviations.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,14 @@
<body>
<h1>Understanding Abbreviations</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can identify and learn what abbreviations mean</dd>
<dt>Author task</dt><dd>Provide the expanded form of abbreviations to users</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Abbreviations</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/audio-control.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Audio Control</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>A page that plays music or sounds doesn't disrupt people</dd>
<dt>Author task</dt><dd>If you play audio content automatically, let people turn it down or off</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Audio Control</h2>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Audio Description or Media Alternative (Prerecorded)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Prerecorded videos can be understood by more people</dd>
<dt>Author task</dt><dd>Provide a description of the visual content in videos</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Audio Description or Media Alternative (Prerecorded)</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/audio-description-prerecorded.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Audio Description (Prerecorded)</h1>

<section id="brief">
<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 spoken description of the visual content in videos</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Audio Description (Prerecorded)</h2>
Expand Down
11 changes: 10 additions & 1 deletion understanding/20/audio-only-and-video-only-prerecorded.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,16 @@
<body>
<h1>Understanding Audio-only and Video-only (Prerecorded)</h1>


<section id="brief">
<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 when content is perceivable with only one sense</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Audio-only and Video-only (Prerecorded)</h2>

Expand Down
8 changes: 8 additions & 0 deletions understanding/20/audio-only-live.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,14 @@
<body>
<h1>Understanding Audio-only (Live)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Live audio can be understood by more people</dd>
<dt>Author task</dt><dd>Provide a text equivalent for live audio-only content</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Audio-only (Live)</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/bypass-blocks.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Bypass Blocks</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can more easily navigate by keyboard</dd>
Copy link
Contributor

Choose a reason for hiding this comment

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

extend "navigate" to "navigate page sections" or "navigate different parts of a page"?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think the end result is easier navigation. Will think on a bit more, but every time I tried to put something like that in, it read a bit more confusingly or inaccurately.

<dt>Author task</dt><dd>Provide a means of skipping repeating content</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Bypass Blocks</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/captions-live.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Captions (Live)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Live videos have captions</dd>
<dt>Author task</dt><dd>Provide synchronized text for audio content in real-time videos</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Captions (Live)</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/captions-prerecorded.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Captions (Prerecorded)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Videos can be played with captions</dd>
<dt>Author task</dt><dd>Provide synchronized text for audio content in existing videos</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Captions (Prerecorded)</h2>
Expand Down
10 changes: 9 additions & 1 deletion understanding/20/change-on-request.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,15 @@
</head>
<body>
<h1>Understanding Change on Request</h1>


<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users have full control of major content changes</dd>
<dt>Author task</dt><dd>Provide ways for users to trigger or turn off changes of context</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Change on Request</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/consistent-identification.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Consistent Identification</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Actions are more predictable across pages</dd>
<dt>Author task</dt><dd>Identify repeating functions consistently</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Consistent Identification</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/consistent-navigation.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Consistent Navigation</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Content can be navigated more predictably</dd>
<dt>Author task</dt><dd>Consistently order navigation that repeats across multiple pages</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Consistent Navigation</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/contrast-enhanced.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Contrast (Enhanced)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Text can be seen by people who need strong contrast</dd>
<dt>Author task</dt><dd>Strongly contrast text against its background</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Contrast (Enhanced)</h2>

Expand Down
10 changes: 10 additions & 0 deletions understanding/20/contrast-minimum.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,16 @@
<body>
<h1>Understanding Contrast (Minimum)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Text can be seen by more people</dd>
<dt>Author task</dt><dd>Provide sufficient contrast between text and its background</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Contrast (Minimum)</h2>

Expand Down
9 changes: 9 additions & 0 deletions understanding/20/error-identification.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Error Identification</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users know an error exists and what is wrong</dd>
mbgower marked this conversation as resolved.
Show resolved Hide resolved
<dt>Author task</dt><dd>Provide descriptive notification of errors</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Error Identification</h2>
Expand Down
8 changes: 8 additions & 0 deletions understanding/20/error-prevention-all.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,14 @@
<body>
<h1>Understanding Error Prevention (All)</h1>

<section id="brief">
<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 any submissions</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Error Prevention (All)</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/error-prevention-legal-financial-data.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Error Prevention (Legal, Financial, Data)</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can avoid submitting incorrect important information</dd>
<dt>Author task</dt><dd>Provide ways for users to confirm, correct, or reverse important submissions</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Error Prevention (Legal, Financial, Data)</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/error-suggestion.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Error Suggestion</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users get suggestions on how to resolve errors</dd>
<dt>Author task</dt><dd>Where errors are detected, suggest known ways to correct them</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Error Suggestion</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/extended-audio-description-prerecorded.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,15 @@
<h1>Understanding Extended Audio Description (Prerecorded)</h1>


<section id="brief">
<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 spoken descriptions of the visual content in videos</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Extended Audio Description (Prerecorded)</h2>

Expand Down
9 changes: 9 additions & 0 deletions understanding/20/focus-order.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Focus Order</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Keyboard users navigate content in a correct order</dd>
<dt>Author task</dt><dd>Elements receive focus in an order that preserves meaning</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Focus Order</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/focus-visible.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Focus Visible</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users know which element has keyboard focus</dd>
<dt>Author task</dt><dd>Ensure each item receiving focus has a visible indicator</dd>
Copy link
Contributor

Choose a reason for hiding this comment

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

indicator -> focus indicator?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

again, you get that from the name of SC plus the use of "focus" 3 words before this in the same phrase. I think it's okay without it.


</dl>

</section>

<section id="intent">
<h2>Intent of Focus Visible</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/headings-and-labels.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Headings and Labels</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>A page's content is described in headings and labels</dd>
<dt>Author task</dt><dd>Provide descriptive headings and labels</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Headings and Labels</h2>
Expand Down
8 changes: 8 additions & 0 deletions understanding/20/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,14 @@
<body>
<h1>Understanding Help</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can avoid making mistakes</dd>
<dt>Author task</dt><dd>Provide help to users on the function currently being performed</dd>
</dl>

</section>

<section id="intent">
<h2>Intent of Help</h2>
Expand Down
9 changes: 9 additions & 0 deletions understanding/20/images-of-text-no-exception.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,15 @@
<h1>Understanding Images of Text (No Exception)</h1>


<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Users can always adjust how text is presented</dd>
<dt>Author task</dt><dd>Avoid pictures of text except where essential</dd>
mbgower marked this conversation as resolved.
Show resolved Hide resolved
</dl>

</section>

<section id="intent">
<h2>Intent of Images of Text (No Exception)</h2>

Expand Down
9 changes: 9 additions & 0 deletions understanding/20/images-of-text.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
<body>
<h1>Understanding Images of Text</h1>

<section id="brief">
<h2>In brief</h2>
<dl>
<dt>Objective</dt><dd>Text that can be easily adapted is used where possible</dd>
mbgower marked this conversation as resolved.
Show resolved Hide resolved
<dt>Author task</dt><dd>Use text instead of pictures of text</dd>

</dl>

</section>

<section id="intent">
<h2>Intent of Images of Text</h2>
Expand Down