yari
yari copied to clipboard
Issue with "Document": some symbols aren't explained in a legend or key
MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/Document
Throughout the page, various list items are marked with small icons. One is a trashcan, but a trashcan icon is not in the key near the bottom of the page (just below the compatibility chart). Also, some list items are red, and red vs. black is not documented in the key. (And further, using only color to convey information is an accessibility violation.)
Specific section or headline? The icons and red are used throughout the page. The key that is missing the definition of them is at the bottom of https://developer.mozilla.org/en-US/docs/Web/API/Document#browser_compatibility
What did you expect to see? A key that defines all 'codes'.
Did you test this? no
MDN Content page report details
- Folder:
en-us/web/api/document - MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/Document
- GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/document/index.md
- Last commit: https://github.com/mdn/content/commit/8e65ef1ae04e60b828482fa18bdeac04bcf379f8
- Document last modified: 2021-09-15T07:56:41.000Z
Thanks for reporting this, @skcodes.
This is closely related to https://github.com/mdn/content/discussions/5549. We don't have a consistent terminology to communicate status (experimental, deprecated, standards-track) and we don't consistently use symbols to refer to these things (and perhaps shouldn't use symbols at all, outside of compat tables).
Tagging this as infra, though that's not exactly right.