Skip to content

Commit 37d85a3

Browse files
TOC structure and naming Learn A11y modules (GoogleChrome#9279)
* directory name * testing modules url structure * toc * Move JS module after focus and document * focus management * line breaks * description updates.
1 parent 33c1b17 commit 37d85a3

File tree

9 files changed

+32
-24
lines changed

9 files changed

+32
-24
lines changed

src/site/_data/courses/accessibility/toc.yml

+5-5
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,19 @@
22
- url: /learn/accessibility/why
33
- url: /learn/accessibility/measure
44
- url: /learn/accessibility/aria-html
5-
- url: /learn/accessibility/javascript
65
- url: /learn/accessibility/structure
76
- url: /learn/accessibility/more-html
7+
- url: /learn/accessibility/focus
8+
- url: /learn/accessibility/javascript
89
- url: /learn/accessibility/images
910
- url: /learn/accessibility/color-contrast
1011
- url: /learn/accessibility/motion
1112
- url: /learn/accessibility/typography
1213
- url: /learn/accessibility/video-audio
1314
- url: /learn/accessibility/forms
14-
- url: /learn/accessibility/focus
1515
- url: /learn/accessibility/patterns
1616
- url: /learn/accessibility/design-ux
17-
- url: /learn/accessibility/automated-test
18-
- url: /learn/accessibility/manual-test
19-
- url: /learn/accessibility/assitive-technology
17+
- url: /learn/accessibility/test-automated
18+
- url: /learn/accessibility/test-manual
19+
- url: /learn/accessibility/test-assistive-technology
2020
- url: /learn/accessibility/glossary

src/site/content/en/learn/accessibility/color-contrast/index.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,8 @@
22
title: 'Color and contrast'
33
authors:
44
- cariefisher
5-
description: How to create accessible color palettes with appropriate contrast.
5+
description: >
6+
Build accessible color palettes with appropriate contrast.
67
date: 2022-09-30
78
tags:
89
- accessibility

src/site/content/en/learn/accessibility/javascript/index.md

+10-8
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ tags:
1010
- accessibility
1111
---
1212

13-
In development today, JavaScript plays a major role in almost everything we
14-
create—from smaller dynamic components to full products running on a JavaScript
15-
framework, such as React or Angular.
13+
JavaScript plays a major role in almost everything we create—from smaller
14+
dynamic components to full products running on a JavaScript framework, such as
15+
React or Angular.
1616

1717
This use (or overuse) of JavaScript has brought forward many alarming trends,
1818
such as long load times due to large amounts of code, use of non-semantic HTML
@@ -151,10 +151,11 @@ concise, and of course, accessible.
151151

152152
## Focus management
153153

154-
In the [Keyboard focus module](/learn/accessibility/focus), we covered focus order
155-
and indicator styles. Focus management is knowing when and where to trap the
156-
focus and when it shouldn't be trapped. Focus management is critical for
157-
keyboard-only users.
154+
In the [Keyboard focus module](/learn/accessibility/focus), we covered focus
155+
order and indicator styles. Focus management is knowing when and where to trap
156+
the focus and when it shouldn't be trapped.
157+
158+
Focus management is critical for keyboard-only users.
158159

159160
### Component level
160161

@@ -195,7 +196,8 @@ JavaScript is essential to properly trapping this focus.
195196
### Page level
196197

197198
Focus must also be maintained when a user navigates from page-to-page. This is
198-
especially true in SPAs, where there is [no browser refresh](https://marcysutton.com/prototype-testing-accessible-clientside-routing/),
199+
especially true in SPAs, where there is
200+
[no browser refresh](https://marcysutton.com/prototype-testing-accessible-clientside-routing/),
199201
and all content dynamically changes. Anytime a user clicks on a link to go
200202
to another page within your application, the focus is either kept in the same
201203
place or potentially placed somewhere else entirely.

src/site/content/en/learn/accessibility/measure/index.md

+9-6
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ title: 'How is digital accessibility measured?'
33
authors:
44
- cariefisher
55
description: >
6-
Introduction to measuring accessibility of digital products so that
7-
everyone, including people with disabilities, can still interact in
8-
a meaningful and equal way.
6+
Introduction to accessibility measurement, which ensures everyone,
7+
including people with disabilities, can still interact with your website
8+
in a meaningful and equal way.
99
date: 2022-09-30
1010
tags:
1111
- accessibility
@@ -40,9 +40,12 @@ _[accessibility audit](https://www.w3.org/WAI/test-evaluate/)_.
4040
An accessibility audit uses various methodologies, techniques, and tools,
4141
including design, automated, manual, and assistive technology (AT) testing.
4242

43-
Perform an accessibility audit to capture the baseline accessibility compliance of a digital product. But, running it once at the start of a project is not enough to determine if a product is accessible. You should run this audit multiple times throughout the software product lifecycle to check for changes in the level of conformance, against a set of pre-determined accessibility checkpoints or guidelines.
44-
45-
We'll cover how to conduct an accessibility audit in the foundational conformance testing module, coming soon.
43+
Perform an accessibility audit to capture the baseline accessibility compliance
44+
of a digital product. But, running it once at the start of a project is not
45+
enough to determine if a product is accessible. You should run this audit
46+
multiple times throughout the software product lifecycle to check for changes
47+
in the level of conformance, against a set of pre-determined accessibility
48+
checkpoints or guidelines.
4649

4750
## Web Content Accessibility Guidelines (WCAG) {:#wcag}
4851

src/site/content/en/learn/accessibility/typography/index.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22
title: 'Typography'
33
authors:
44
- cariefisher
5-
description: How to create accessible typography.
5+
description: >
6+
Pick the right typefaces, font sizes, and structure your copy with
7+
an accessible layout.
68
date: 2022-09-30
79
tags:
810
- accessibility

src/site/content/en/learn/accessibility/why/index.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
title: What is digital accessibility, and why does it matter?
33
description: >
4-
Learn how why it matters to design and build websites and web
5-
apps so that disabled people can interact with them in a meaningful
6-
and equivalent way.
4+
Design and build websites and web apps so that disabled people can
5+
interact in a meaningful and equivalent way. Read about the business
6+
and legal impact of these choices.
77
authors:
88
- cariefisher
99
date: 2022-09-30

0 commit comments

Comments
 (0)