microsoft / microsoft/Power-Fx
Improve alt text in images
Nobody has claimed this yet.
- Dominant language
- C#
- Stars
- 3.4k
- Forks
- 358
- Avg merge
- 10h 34m
- Merged PRs (30d)
- 3
Description
The images in the documentation don't have descriptive alternative text. For example, in the overview document, what I believe screenshots are provided. The images were text is writen and where that text is meaningful should have the alt attribute set to that text rather than a generic description, or the image should be substituted by the text. I haven't looked much in the documentation, but maybe there are images where information which is not text is not correctly conveyed for a blind user through the alt attribute.
(The alt attribute is set between the exclamation point and the closing square bracket)
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the images in the overview document and then inspect the remaining documentation for screenshots and other images. Check each image's alt attribute, replacing generic descriptions with meaningful text or substituting text where the image only presents written content. Done means the documented information is conveyed to blind users through appropriate alternative text.
Written by the indexing model from the issue text.
Assessment
- Domain
- accessibility, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100