[a11y] Component accessibility documentation

[dpersing]

Want to add a quick PR to help improve our documentation? Want to support accessibility work in Polaris? Do I have the project for you.

Check out the project history for more details.

See all of the drafts including content for guides and patterns, for copy.

How to do it

1. If you want to do some writing, check out components in the To do or Outlined sections.
2. If you want to do some editing, see Written.
3. If a component's documentation has been edited and is ready for a PR, go ahead and open one. Keep an eye out for documentation that references other components; we'll want to make sure those references get released together or are already out.
4. If you want to review open PRs, take a look at Open PRs.

Formatting content

The component docs live in the README.md file for the component. To add a section, add this snippet to the end of the README.me file:

---

## Accessibility

<!-- content-for: android -->

See Material Design and development documentation about accessibility for Android:

- [Accessible design on Android](https://material.io/design/usability/accessibility.html)
- [Accessible development on Android](https://developer.android.com/guide/topics/ui/accessibility/)

<!-- /content-for -->

<!-- content-for: ios -->

See Apple’s Human Interface Guidelines and API documentation about accessibility for iOS:

- [Accessible design on iOS](https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/accessibility/)
- [Accessible development on iOS](https://developer.apple.com/accessibility/ios/)

<!-- /content-for -->

<!-- content-for: web -->

...Your new content...

<!-- /content-for -->

Check out the merged PRs for examples.

Questions?

Ask @dpersing about things in general or ask @sadiesaurus about content/editing specifically.

Status

To do

• Button group (dependent on [DO-NOT-MERGE][Button] Add pressed state #984)
• Resource picker
• Top bar

Outlined

• Form layout
• Frame
• Navigation
• Scrollable
• Select
• Skeleton body text
• Skeleton display text
• Skeleton page

Written

• Color picker
• Footer help (references link)
• Page
• Page actions
• Pagination (references button, link, tooltip)
• Tabs
• Thumbnail
• Tooltip

Open PRs

Merged

• Account connection (PR [a11y] Account connection and setting toggle a11y docs #970, released in 3.7.0)
• Action list (PR [a11y] Add action and option list accessibility docs #1365, released in 3.14.0)
• Autocomplete (PR [a11y] Autocomplete and text field a11y docs #968, released in 3.8.0)
• Avatar (PR [a11y] Avatar component a11y docs #973, released in 3.7.0)
• Badge (PR [a11y] Add documentation for the badge component #1364, released in 3.14.0)
• Banner (PR [a11y] Banner a11y docs #1071, released in 3.10.0)
• Button (PR Button and link a11y docs #924, released in 3.8.0)
• Callout card (PR [a11y] Add docs for card and callout card components #1366, released in 3.14.0)
• Caption (PR Caption a11y docs #928, released in 3.6.0)
• Card (PR [a11y] Add docs for card and callout card components #1366, released in 3.14.0)
• Checkbox (PR [a11y] Docs for checkbox, radio button, and choice list #1145, released in 3.11.0)
• Choice list (PR [a11y] Docs for checkbox, radio button, and choice list #1145, released in 3.11.0)
• Collapsible (PR [a11y] Collapsible a11y docs #1631, released in 3.17.0)
• Data table (Data table and resource list a11y docs #927, released in 3.6.0)
• Date picker (PR [a11y] Add date picker component a11y docs #2242, released in 4.5.0)
• Description list (PR [a11y] Description list a11y docs #1634, released in 3.17.0)
• Display text (PR [a11y] Add accessibility guidance for display text #1354, released in 3.14.0)
• Drop zone (PR [a11y] Add drop zone component a11y docs and edit description #2243, released in 4.6.0)
• Empty state (PR [a11y] Add empty state component a11y docs  #2244, released in 4.5.0)
• Exception list (PR [a11y] Exception list a11y docs #1635, released in 3.17.0)
• Form (PR [a11y] Form a11y docs #1636, released in 3.17.0)
• Heading (PR [a11y] Added doc updates for the heading and subheading components #1351, released in 3.14.0)
• Icon (PR [a11y] Icon accessibility docs #1404, released in 3.14.0)
• Inline error (PR [a11y] Inline error a11y docs #1073, released in 3.10.0)
• Keyboard key (PR [a11y] Add keyboard key docs #1640, released in 3.17.0)
• Link (PR Button and link a11y docs #924, released in 3.8.0)
• List (PR Added a11y docs for list and stack #1353, released in 3.14.0)
• Loading (PR Loading a11y docs #1075, released in 3.10.0)
• Modal (PR [a11y] Adds docs for the modal #1648, released in 3.17.0)
• Option list (PR [a11y] Add action and option list accessibility docs #1365, released in 3.14.0)
• Popover (PR [a11y] Popover accessibility docs #1408, released in 3.14.0)
• Radio button (PR [a11y] Docs for checkbox, radio button, and choice list #1145, released in 3.11.0)
• Range slider (PR [a11y] Range slider a11y docs #1630, released in 3.17.0)
• Resource list (Data table and resource list a11y docs #927, released in 3.6.0)
• Setting toggle (PR [a11y] Account connection and setting toggle a11y docs #970, released in 3.7.0)
• Sheet (PR [Sheet] build sheet component #1250, released with initial component in 3.14.0)
• Stack (PR Added a11y docs for list and stack #1353, released in 3.14.0)
• Spinner (PR [a11y] Add drop zone component a11y docs and edit description #2243, released in 4.6.0)
• Subheading (PR [a11y] Added doc updates for the heading and subheading components #1351, released in 3.14.0)
• Tag (PR [a11y] Docs for the tag component #1647, released in 3.17.0)
• Text style (PR [a11y] Added an accessibility section to the text style component docs #1350, released in 3.14.0)
• Text field (PR [a11y] Autocomplete and text field a11y docs #968, released in 3.8.0)
• Toast (PR [Toast] Add action prop #919, released in 3.11.0)
• Visually hidden (PR [a11y] Added a11y docs to the visually hidden component #1348, released in 3.14.0)

[alex-page]

Nice!