"Learn more" links are not descriptive enough to understand the purpose in the TypeSpec page: A11y_TypeSpec_Link Purpose

[kupatkar99]

GIT Hub Tags:

#A11yTCS; #A11ySev2; #TypeSpec; #GH_TypeSpec_Web_Sept2025; #DesktopWeb; #A11yMAS; #WCAG2.4.4; #Link Purpose; #AILimited; #Win11; #FTP; #ChromiumEdge;

Environment and OS details:

Application name: typespec.io
URL: https://typespec.io/
ChromiumEdge Version: 140.0.3485.66 (Official build) (64-bit)

Reproduction Steps:

1. Open url https://typespec.io/ and login with valid Credentials.
2. "TypeSpec" Page will get open.
3. TAB to "Learn More" Link under "Why Typespec" section in TypeSpec Page.
4. Observe the issue whether "Learn more" links are descriptive enough to understand the purpose in the "TypeSpec" Page or not.

Actual behavior:

"Learn more" links are not descriptive enough to understand the purpose "Why Typespec" section in TypeSpec Page..

Expected behavior:

Since there are multiple "Learn more" links in the page, the links should be descriptive enough to understand the purpose of the links.

User Impact:

Screen reader users may confuse if the links "learn more" are not descriptive enough to understand the purpose and making it unclear what users will learn or where the link leads.

Attachment:

[ccbarragan]

Hey @timotheeguerin! For the 'Learn more' links in the Why TypeSpec section, let's update the labels to be more descriptive. Here are some recommendations:

• Learn about TypeSpec for REST APIs
• Learn about TypeSpec emitters
• Check out multi-protocol examples

For the 'Learn more' links in the cards, would it be possible to update design of the card to be interactive / selectable? If so recommend we remove the links and update the descriptions. Example:

Link to Figma

[timotheeguerin]

Those card were already interactive so it is a quick fix

[kupatkar99]

Verified the issue in below Environment:
https://typespec.io/
issue is fixed. Hence Closing the bug. please find added attachment for reference.

#Closed;