terra-avatar UX Audit

[ryanthemanuel]

terra-avatar

Known Aliases

Document any known aliases of the component, decide if another name makes more sense.

• Has known aliases
• Requires name change

Design Standard Doc

Any documentation needed to be added to terra-ui describing the make up and usage of the component
Any doc examples that need to be updated?

• Missing design standard documentation linkage.

Guides

Any guides needed to be added to terra-ui describing the usage of this component when used with other components.

• Missing Guides
  • What to do with different data available for names (e.g. only one name, two names, etc.)
  • What to use for hashValue
  • Avatar should not be sole indicator that the patient is deceased
  • Update the photos in the examples
  • For generic we need to make sure that we have specific examples
• Missing UX recommended Usage.
• Deprecation guide

Accessibility Guides

• Missing Accessibility Guides
  • When to use isAriaHidden (or how to use avatar in such a way that it is not relied upon as the source of information)

Behaviours

• Missing behaviours
  • Possibly rename or remove isAriaHidden so that our default value is more representative of what we would expect from the component. Also potentially make alt null along with this.
• Contains bad practice behaviours that should be removed

Accessibility

• Meets wcag 2.0/section 508 standards
• Meets wcag 2.1/en 301 549 standards

Deprecation

• Component is a bad pattern and should be deprecated.

Related Issues

Other Considerations