yari icon indicating copy to clipboard operation
yari copied to clipboard

Issue with "Document": some symbols aren't explained in a legend or key

Open skcodes opened this issue 4 years ago • 1 comments

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

skcodes avatar Nov 02 '21 13:11 skcodes

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.

ddbeck avatar Nov 17 '21 15:11 ddbeck