microsoft / microsoft/Power-Fx

Improve alt text in images

Open
#12 0 comments 0 reactions 0 assignees View on GitHub

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

  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 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.