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

Update content for accessibility chapter #359

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 38 additions & 5 deletions docs/accessibility/further-reading.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,45 @@
---
sidebar_position: 7
---

Further Reading
===========
Additional accessibility resources can go here.
===============

Additional accessibility resources to help you learn more about accessibility and how to make your website more accessible.

## General

- [UN Convention on the Rights of Persons with Disabilities](https://www.un.org/development/desa/disabilities/convention-on-the-rights-of-persons-with-disabilities/article-9-accessibility.html)
- [Accessibility Fundamentals](https://www.w3.org/WAI/fundamentals)
- [How to meet WCAG](https://www.w3.org/WAI/WCAG22/quickref/)
- [Inclusive Design Principles](https://inclusivedesignprinciples.info/)
- [Accessibility Myths](https://a11ymyths.com/)

## Blogs
- [Sara Soueidan](https://www.sarasoueidan.com/blog/)
- [Eric Eggert](https://yatil.net/blog)

## Alternative text for images
- [Writing Alt Text for Data Visualization](https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81)
- [Write helpful Alt Text to describe images](https://accessibility.huit.harvard.edu/describe-content-images)
- [How to Write Alt Text for Images: Best Practices & Examples](https://kdesign.co/blog/how-to-write-alt-text/)
- [Are you making these five mistakes when writing alt text?](https://www.a11yproject.com/posts/are-you-making-these-five-mistakes-when-writing-alt-text/)

:::caution TODO
## Browser Tools
- [Lighthouse (included Chrome)](https://developer.chrome.com/docs/lighthouse/)
- [Wave](https://wave.webaim.org/)
- [axe DevTools](https://www.deque.com/axe/devtools/)
- [ANDI](https://www.ssa.gov/accessibility/andi/help/install.html)
- [Landmarks](http://matatk.agrip.org.uk/landmarks/)
- [IBM Equal Access Accessibility Checker](https://www.ibm.com/able/toolkit/tools/#develop)

This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
## Screenreader
- [NDVA (Windows)](https://www.nvaccess.org/)
- [VoiceOver (MacOS)](https://support.apple.com/de-at/guide/voiceover/welcome/mac)
- [Setting up a screen reader testing environment on your computer](https://www.sarasoueidan.com/blog/testing-environment-setup/)

:::
## Checklisten & Co.
- [The A11y Project](https://www.a11yproject.com/checklist/)
- [Webflow](https://webflow.com/accessibility/checklist)
- [Deque University](https://dequeuniversity.com/checklists/web/)
- [IAAP](https://www.accessibilityassociation.org/s/certification)
9 changes: 3 additions & 6 deletions docs/accessibility/reporting-issues.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,9 @@
---
sidebar_position: 6
---
Reporting Errors
===========
How do people report accessibility issues in the CMS or template to us?

:::caution TODO
Reporting Errors
================

This page is unfinished, please use the **Edit this Page** link at the bottom of this page to help make it more useful.
You can report accessibility issues in the CMS (using the standard Cassiopeia template) sending us an email to: [[email protected]](mailto:[email protected])

:::