AC Content revision joe

Gemfile.lock

@@ -72,6 +72,7 @@ PLATFORMS
   arm64-darwin-20
   arm64-darwin-21
   arm64-darwin-22
+  arm64-darwin-23
   x86_64-darwin-20
   x86_64-linux
 

_checklist-web/breadcrumbs.md

@@ -7,7 +7,7 @@ order: 1
 
 keyboard:
   tab: |
-    Focus visibly moves to the link
+    Focus moves to the link and there is a highly visible visual indication of keyboard focus
   enter: |
     Activates the link
 
@@ -31,7 +31,7 @@ gherkin-keyboard:
   - when:  |
       the tab key to move focus to a link
     result: |
-      focus is strongly visually indicated
+      there is a highly visible visual indication of keyboard focus
   - then:  |
       the enter key to activate the link
     result: |
@@ -63,7 +63,7 @@ wcag:
   - name: Robust
     list:
       - criteria: Meets criteria across platforms, devices and viewports
-      - criteria: Conveys the correct semantic role
+      - criteria: Conveys the correct semantic role and current state is announced
 ---
 
 ## Code example

_checklist-web/button.md

@@ -7,7 +7,7 @@ order: 1
 
 keyboard:
   tab: |
-    Focus visibly moves to the button.
+    Focus moves to the button and there is a highly visible visual indication of keyboard focus
   spacebar: |
     Activates the button.
   enter: |
@@ -33,7 +33,7 @@ gherkin-keyboard:
   - when:  |
       the tab key to move focus to a button
     result: |
-      focus is strongly visually indicated
+      there is a highly visible visual indication of keyboard focus
   - then:  |
       the spacebar and/or enter key to activate the button
     result: |

_checklist-web/footer.md

@@ -7,7 +7,7 @@ order: 9
 
 keyboard:
   skip-links: |
-    Focus moves directly to the footer
+    If a skip link points to the footer, focus moves directly to the footer
   tab: |
     Links and buttons within the footer are focusable
 

_checklist-web/form.md

@@ -13,15 +13,13 @@ mobile:
   swipe: |
     Focus moves to the inputs inside the form
   keyboard: |
-    Keyboard appears
+    Keyboard appears when interacting with text fields
 
 screenreader:
   name:  |
     If multiple forms are present (Ex: Search, Sign in, Newsletter subscription), the form must have a name
   role:  |
     It is discoverable with screenreader shortcuts as a form landmark along with its name
-  mode:  |
-    the screenreader switch from browse shortcuts to forms shortcuts
 
 gherkin-keyboard: 
   - when:  |

_checklist-web/header.md

@@ -9,10 +9,8 @@ keyboard:
   skip-links: |
     Focus moves directly to the header or navigation
   tab: |
-    Nothing, headings are not focusable unless they are actionable
-  arrow-keys: |
-    Headings are browsed
-
+    Nothing, headers are not typically in the tab order
+
 mobile:
   swipe: |
     Focus moves directly to the header or navigation
@@ -29,7 +27,7 @@ gherkin-keyboard:
   - when:  |
       the tab key to enter the web browser window
     result: |
-      focus is strongly visually indicated on interactive components
+      that there is a highly visible visual indication of keyboard focus on interactive controls within the header
 
 gherkin-mobile:
   - when:  |

_checklist-web/html.md

@@ -8,8 +8,6 @@ order: 0
 keyboard:
   tab: |
     Enters the page and visibly focuses only interactive elements
-  zoom: |
-    Content zooms up to 200%
 
 mobile:
   swipe: |
@@ -29,7 +27,7 @@ gherkin-keyboard:
   - when:  |
       the keyboard to open a new web page
     result: |
-      the page has a unique logical title in the browser tab
+      a highly noticeable visual indication of keyboard focus on focusable controls
 
 gherkin-mobile:
   - when:  |
@@ -40,8 +38,8 @@ gherkin-mobile:
       content is accessible in landscape or portrait orientation
 
 settings:
-  zoom/pinch: |
-    text can resize up to 200% without losing information
+  zoom: |
+    Text can be zoomed to 200% and the page can be zoomed to 400% without a loss of content or two-dimensional scrolling
 ---
 ## Developer notes
 

_checklist-web/link.md

@@ -27,7 +27,7 @@ gherkin-keyboard:
   - when:  |
       the tab key to move focus to a link
     result: |
-      focus is strongly visually indicated
+      there is a highly visible visual indication of keyboard focus
   - then:  |
       the enter key to activate the link
     result: |

_checklist-web/main.md

@@ -13,13 +13,13 @@ keyboard:
 
 mobile:
   swipe: |
-    Focus moves within main area
+    Focus moves within the main area
 
 screenreader:
   role:  |
     It is discoverable with screenreader shortcuts as main landmark
   group: |
-    It contains the content portion of the page starting with the H1
+    It contains the content portion of the page ideally starting with the H1
 
 gherkin-keyboard: 
   - when:  |
@@ -29,7 +29,7 @@ gherkin-keyboard:
 
 gherkin-mobile:
   - when:  |
-      swipe to elements in the header
+      swipe to elements in the page
 
 ---
 

_checklist-web/nav.md

@@ -7,9 +7,9 @@ order: 2
 
 keyboard:
   skip-links: |
-    Focus moves directly to the nav element
+    Focus moves directly to the nav element or the first focusable control in the nav
   tab: |
-    Focus moves to Links and buttons within the nav
+    Focus moves to controls within the nav and there is a highly visible visual indication of keyboard focus
 
 mobile:
   swipe: |
@@ -19,15 +19,15 @@ mobile:
 
 screenreader:
   name:  |
-    It indicates its role AND IF multiple navigations are present (ex: Main navigation, Site map, Breadcrumbs), the name of the navigation
+    it indicates its role AND IF multiple navigations are present (ex: Main navigation, Site map, Breadcrumbs), the name of the navigation
   role:  |
-    It is discoverable with screenreader shortcuts as a navigation landmark
+    it is discoverable with screenreader shortcuts as a navigation landmark
 
 gherkin-keyboard: 
   - when:  |
-      the arrow keys to browse the navigation menu
+      tab is used to browse the navigation menu
     result: |
-      the screen scrolls through the page
+      that there is a highly visible visual indication of keyboard focus on interactive controls within the navigation region
 
 gherkin-mobile:
   - when:  |

_checklist-web/pagination.md

@@ -29,15 +29,15 @@ gherkin-keyboard:
   - then:  |
       the tab key to move focus to a link in the nav and use the enter key
     result: |
-      my browser goes to the intended location
+      my browser goes to the intended location or the page is dynamically updated and I'm notified about this change in the UI
 
 gherkin-mobile:
   - when:  |
       swipe to elements in the nav
   - then:  |
       doubletap with the link in focus
     result: |
-      my browser goes to the intended location
+      my browser goes to the intended location or the screen is dynamically updated and I'm notified about this change in the UI
 
 wcag:
   - name: Perceivable

_checklist-web/search.md

@@ -7,17 +7,17 @@ categories: nav header
 
 keyboard:
   tab: |
-    Focus moves visibly to the search text input and search button
+    Focus moves to the search text input and search button [if present] and there is a highly visible visual indication of keyboard focus
   space: |
-    Search button is activated
+    Search button is activated [if present]
   enter: |
-    Search is activated
+    Search is activated [if present]
 
 mobile:
   swipe: |
-    Focus moves to the search text input and search button
+    Focus moves to the search text input and search button [if present]
   doubletap: |
-    Search button is activated
+    Search button is activated [if present]
 
 screenreader:
   name:  |
@@ -31,9 +31,9 @@ gherkin-keyboard:
   - when:  |
       the tab key to move focus to a search input
     result: |
-      focus is strongly visually indicated
+      there is a highly visible visual indication of keyboard focus
   - then:  |
-      the tab key to move focus to the search submit button
+      the tab key to move focus to the search submit button [if present]
     result: |
       the button is focused
   - then:  |
@@ -55,9 +55,8 @@ wcag:
   - name: Operable
     list:
       - criteria: Is keyboard operable
-      - criteria: Any click/tap target area is no smaller than 44x44px
+      - criteria: Any click/tap target area is ideally no smaller than 44x44px
       - criteria: The disabled and focus states have a 3:1 minimum contrast ratio against default
-      - criteria: The focus indication has a minimum area equal to the width of the element and 2px in height
       - criteria: A search submit button is also available and meets button design criteria
   - name: Understandable
     list:

_checklist-web/skip-link.md

@@ -8,7 +8,7 @@ order: 1
 
 keyboard:
   tab: |
-    Focus moves to the skip link
+    Focus moves to the skip link and there is a visual indication of keyboard focus
   enter: |
     Activates the link, focus/tabindex moves directly to the targeted element