Skip to content

A number of pages have images with poor alt text that can't actually be followed #1265

@corbob

Description

@corbob

Checklist

  • I have verified this is the correct repository for opening this issue.
  • I have verified no other issues exist related to my request.

Is Your Feature Request Related To A Problem? Please describe.

We should update the alt text for the below pages. Currently the alt text is to the effect of Feature name, if you're on <docs url>, please see the HTML comment below for full description, and then there is a comment below that Astro does not actually convert into an HTML comment.

  • package-audit.mdx
  • package-builder.mdx
  • package-internalizer.mdx
  • package-reducer.mdx
  • package-throttle.mdx
  • self-service-anywhere.mdx
  • shim.mdx
  • automatic-sync.mdx
  • packages-to-programs.mdx
  • sync-commands.mdx

Describe The Solution. Why is it needed?

We need to ensure that all images have alt text that accurately describe the image.

User Story

As a user of docs.chocolatey.org,
I want to be shown descriptive text if an image is not displayed correctly,
so that I can understand what the image would have been displaying.

Additional Context

With NVDA running, the text read out is very cumbersome.

Helpful links:

Acceptance Criteria

  • As a user the alt text shown on a missing image accurately describes the image and it's importance.
  • NVDA should be able to accurately read out image alt text.
  • No images on docs.chocolatey.org should be left without proper alt text.

Related Issues

n/a

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions