AVT- Hyperlinks must contain link text or an image with alt text

Summary

For hyperlinks, use link text within the element, or add the alt attribute to an image of the link.

Steps to reproduce

GitLab->Help

What is the expected correct behavior?

Assistive technologies must be able to gather information about user interface controls in page content. Providing the role, state, and value information for all user interface controls helps to ensure compatibility with assistive technologies used by people with disabilities. Without proper link information, users are unable to determine the purpose of a link.

Possible fixes

Before investigating this issue, resolve any errors related to invalid IDs.

  • Identify the <a> element (anchor or hyperlink) that caused the error.
  • Add appropriate link text if the hyperlink is a common format without an image.
  • Verify the <img> element contains the alt attribute with an appropriate descriptive value if the hyperlink contains an image.

For example:
This example shows a hyperlink containing an image with alternative text:

  <a title="Print this page" href="print.htm"><img src="img.png" alt="Print this page"></a>        

This example shows a hyperlink with link text:

  <a href="routes.html">Optional travel routes for your desired trip</a>

Relevant screenshots

  • [GitLab Help Homepage] (All h tag {h1~h6} content in Help Documentation page with a element have this problem) image
  • image
  • [GitLab Help - All subpages of Help Documentation have this same problem] - https://gitlab.com/help/

@sharonchen @carmacleod gitlab-ce2677490 gitlab-ce2278648

Edited by Taurie Davis