diff --git a/_articles/accessibility-best-practices-for-your-project.md b/_articles/accessibility-best-practices-for-your-project.md index 4b9e7a00de4..18981cffd1b 100644 --- a/_articles/accessibility-best-practices-for-your-project.md +++ b/_articles/accessibility-best-practices-for-your-project.md @@ -43,9 +43,9 @@ Add a clear statement that sets expectations and makes it easy for users to repo ### Goals -* State measurable goals (like [WCAG AA](https://www.w3.org/TR/WCAG22/#wcag-2-layers-of-guidance) where feasible). -* Primary priorities, and how you meet them (keyboard and screen reader support, captions and transcripts, etc.). -* Any known limitations, and alternative workarounds (if present). +* State measurable goals and guidelines (like [WCAG AA](https://www.w3.org/TR/WCAG22/#wcag-2-layers-of-guidance) where feasible). +* Define primary priorities, and how you meet them (keyboard and screen reader support, captions and transcripts, etc.). +* Define any known limitations, and alternative workarounds (if present). ### Contributor requirements @@ -101,7 +101,7 @@ Documentation is often the first "UI" users touch. Make sure everyone can read i ### Tables * Use tables only for tabular data, not for layout. -* Include **header cells** (``) and use `scope` attributes to associate headers with data cells. +* Provide **header cells** to associate column and row headers with data cells. * Provide a **caption or summary** describing the table's purpose. ### Code blocks @@ -123,8 +123,8 @@ If your project has a web UI, these high-impact defaults will help all users. ### Semantics first -* Use native HTML elements (`

`, `