Skip to content

Commit 83f0d6d

Browse files
committed
Update README.md
1 parent 39fa5ea commit 83f0d6d

File tree

1 file changed

+4
-23
lines changed

1 file changed

+4
-23
lines changed

README.md

Lines changed: 4 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -24,28 +24,9 @@ Are suggestions only, or used for internal navigation/reference. Don't feel you
2424
Tabs, indentation, comments, etc. are my personal preference. It's more important to be consistent than literal when using for your own project. Use [EditorConfig](http://editorconfig.org/) to help make this easier.
2525

2626
### Accessibility Testing
27-
This page has been tested via the Chrome DevTools [Accessibility Audit](https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en), as well as [WebAIM's WAVE](http://wave.webaim.org/extension/) and [Deque System's aXe](http://www.deque.com/products/axe/#aXeExtensions) accessibility testing browser extensions, as well as [Khan Academy's tota11y bookmarklet](http://khan.github.io/tota11y/). Answers to specific warnings are:
28-
29-
#### DevTools Audit
30-
| Error | Reasoning |
31-
| :---- | :-------- |
32-
| [Warning] role=main should only appear on significant elements | `role="main"` is applied to the sole `<main>` element on the page. |
33-
| [Warning] The purpose of each link should be clear from the link text | This is good advice. I'm going with brevity in the document for the sake of expediency, but don't do this in a production environment. |
34-
| [Warning] These elements are focusable but either invisible or obscured by another element | This error is being triggered by the fallback markup for the `<audio>`, `<video>`, etc. elements and should be retained. |
35-
36-
#### aXe
37-
| Error | Reasoning |
38-
| :---- | :-------- |
39-
| Documents must have `<title>` element to aid in navigation | This error is generated from the `about:blank` page in the `<iframe>` example. |
40-
| `<html> `element must have a valid lang attribute | This error is generated from the `about:blank` page in the `<iframe>` example. |
41-
| `<ul>` and `<ol>` must only directly contain `<li>`, `<script>` or `<template>` elements | Nested lists are valid markup. |
42-
| `<video>` elements must have an audio description track | This error won't apply when the provided `track` attribute is linked to a valid subtitle file. |
43-
44-
#### WAVE
45-
| Error | Reasoning |
46-
| :---- | :-------- |
47-
| Suspicious link text. Link text contains extraneous text or may not make sense out of context. | This is good advice. I'm going with brevity in the document for the sake of expediency, but don't do this in a production environment. |
48-
| Redundant link. Adjacent links go to the same URL. | Links have been given a null value. This error shouldn't appear when actual link `href` values have been included. |
27+
This page has been tested via the Chrome DevTools [Accessibility Audit](https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en), as well as [WebAIM's WAVE](http://wave.webaim.org/extension/) and [Deque System's aXe](http://www.deque.com/products/axe/#aXeExtensions) accessibility testing browser extensions, as well as [Khan Academy's tota11y bookmarklet](http://khan.github.io/tota11y/).
28+
29+
Specific answers to specific warnings issues are avaiable on the [repo's Wiki](https://github.com/ericwbailey/accessible-html-content-patterns/wiki).
4930

5031
**A note about [ARIA](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA):** ARIA is a band-aid and not a cure-all. Use semantic markup whenever possible.
5132

@@ -55,7 +36,7 @@ Contributions are welcome! Submit a [Pull Request](https://github.com/ericwbaile
5536

5637

5738
## Credits, Attribution, and Inspiration
58-
- [Adam Morse](http://mrmrs.cc/)'s [mrmrs/html](https://github.com/mrmrs/html)
39+
- [Adam Morse](http://mrmrs.cc/)'s [mrmrs/html](https://github.com/mrmrs/html)
5940
- [HTML5 Doctor](http://html5doctor.com/)
6041
- [Alistair Duggin](http://alistairduggin.co.uk/)'s [Accessibility Fails](http://aduggin.github.io/accessibility-fails/)
6142
- [Paul J. Adam](http://pauljadam.com/)'s [WAI-ARIA Landmarks Site Navigation Structure Demo](http://pauljadam.com/demos/landmarks.html)

0 commit comments

Comments
 (0)