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

Tell users what the deprecated icon (and others) mean. #5844

Closed
3 tasks done
hamishwillee opened this issue Mar 29, 2022 · 0 comments · Fixed by #5644
Closed
3 tasks done

Tell users what the deprecated icon (and others) mean. #5844

hamishwillee opened this issue Mar 29, 2022 · 0 comments · Fixed by #5644
Labels
🐛 bug Something isn't working, or isn't working as expected has PR Issues that already have a PR needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened.

Comments

@hamishwillee
Copy link
Contributor

Summary

Consider https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body#attributes

The attributes are marked as deprecated using the {{deprecated_inline}} macro, which renders as a little bin with a hover as shown:
image

  1. It would be good if this hover actually said the same as BCD: Deprecated. Not for use in new websites."
  2. We get a lot of questions about what deprecated actually means (loooonnnnngggg discussion on this here) because the term has lots of meanings - not just "the spec says don't use it".
  • We'd like to perhaps have a glossary page with this and link to it. Make sense?

URL

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body#attributes

Reproduction steps

Just go to any page

Expected behavior

  1. Hover over icon says "Deprecated. Do not use on new websites"
  2. Make icon link to glossary term explaining what deprecation means. If you agree with approach we'll create that.

Actual behavior

You see the bin icon, you infer it is bad to use, but you don't know under what conditions you can/cannot use it.

Device

Desktop

Browser

Firefox

Browser version

Stable

Operating system

Windows

Screenshot

image

Anything else?

There are some similar issues like #5571 but not for the specific issue of the hover text and possibly providing more information.

Validations

@hamishwillee hamishwillee added the 🐛 bug Something isn't working, or isn't working as expected label Mar 29, 2022
@github-actions github-actions bot added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Mar 29, 2022
danielhjacobs added a commit to danielhjacobs/yari that referenced this issue Mar 29, 2022
@caugner caugner added the has PR Issues that already have a PR label Mar 29, 2022
Repository owner moved this from Backlog to Done in Yari Platform Engineering Apr 12, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🐛 bug Something isn't working, or isn't working as expected has PR Issues that already have a PR needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened.
Projects
Development

Successfully merging a pull request may close this issue.

2 participants