patternfly / patternfly/patternfly-org

Add a11y docs for Icon

Open
#3,810 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A11y PF Team
Dominant language
JavaScript
Stars
74
Forks
147
Avg merge
4d 11h
Merged PRs (30d)
2

Description

We should be sure to include documentation as to when aria-hidden="true" should be passed into an Icon's child as well as if/when an aria-label should be passed.


Jira Issue: PF-1967

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the existing Icon documentation in this repository and review how accessibility guidance is currently presented. Add guidance covering when an Icon child should receive aria-hidden="true" and when an aria-label should be supplied; the documentation is done when both cases are clearly explained.

Written by the indexing model from the issue text.

Assessment

Domain
accessibility, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.