[A11Y] [Medium] External links lack additional context for screen readers #39

New issue

Open

opened 2026-02-19 20:08:40 +00:00 by continue[bot] · 0 comments

continue[bot] commented

2026-02-19 20:08:40 +00:00

(Migrated from github.com)

Accessibility Issue: External Links Missing Context

WCAG Level: A (2.4.4 Link Purpose)
Severity: Medium
Category: Semantic HTML / Link Accessibility

Issue Description

The main page contains external links with text like "Real Estate", "Management Services", and "Linux" that navigate to external domains. While the link text describes the destination, screen reader users may benefit from additional context indicating these are external links.

User Impact

Affected Users: Screen reader users, keyboard-only users
Severity: Users may not realize they are navigating to external sites

Violations Found

File: `content/en/_index.md`

Lines: 6-14

<a class="btn btn-lg btn-primary me-3 mb-4" href="https://property.deployview.com">
  Real Estate
</a>
<a class="btn btn-lg btn-primary me-3 mb-4" href="https://manage.deployview.com">
  Management Services
</a>
<a class="btn btn-lg btn-primary me-3 mb-4" href="https://linux.deployview.com">
  Linux
</a>

Issue: External links could benefit from aria-label or visually hidden text indicating external navigation.

Recommended Fix

<a class="btn btn-lg btn-primary me-3 mb-4" href="https://property.deployview.com" aria-label="Real Estate (external site)">
  Real Estate
</a>
<a class="btn btn-lg btn-primary me-3 mb-4" href="https://manage.deployview.com" aria-label="Management Services (external site)">
  Management Services
</a>
<a class="btn btn-lg btn-primary me-3 mb-4" href="https://linux.deployview.com" aria-label="Linux (external site)">
  Linux
</a>

Changes Made:

Add aria-label attributes to provide additional context for screen readers
Indicate these are external sites in the accessible name

Testing Instructions

Use a screen reader (NVDA, JAWS, VoiceOver) to navigate to the homepage
Tab to each link and verify the announced text includes external site indication
Verify links still function correctly

Resources

Acceptance Criteria

Links updated with aria-label attributes
Tested with screen reader (NVDA/JAWS/VoiceOver)
Keyboard navigation works as expected
Manual testing completed

## Accessibility Issue: External Links Missing Context **WCAG Level:** A (2.4.4 Link Purpose) **Severity:** Medium **Category:** Semantic HTML / Link Accessibility ### Issue Description The main page contains external links with text like "Real Estate", "Management Services", and "Linux" that navigate to external domains. While the link text describes the destination, screen reader users may benefit from additional context indicating these are external links. ### User Impact - **Affected Users:** Screen reader users, keyboard-only users - **Severity:** Users may not realize they are navigating to external sites ### Violations Found #### File: `content/en/_index.md` **Lines:** 6-14 ```markdown <a class="btn btn-lg btn-primary me-3 mb-4" href="https://property.deployview.com"> Real Estate </a> <a class="btn btn-lg btn-primary me-3 mb-4" href="https://manage.deployview.com"> Management Services </a> <a class="btn btn-lg btn-primary me-3 mb-4" href="https://linux.deployview.com"> Linux </a> ``` **Issue:** External links could benefit from `aria-label` or visually hidden text indicating external navigation. --- ### Recommended Fix ```markdown <a class="btn btn-lg btn-primary me-3 mb-4" href="https://property.deployview.com" aria-label="Real Estate (external site)"> Real Estate </a> <a class="btn btn-lg btn-primary me-3 mb-4" href="https://manage.deployview.com" aria-label="Management Services (external site)"> Management Services </a> <a class="btn btn-lg btn-primary me-3 mb-4" href="https://linux.deployview.com" aria-label="Linux (external site)"> Linux </a> ``` **Changes Made:** 1. Add `aria-label` attributes to provide additional context for screen readers 2. Indicate these are external sites in the accessible name ### Testing Instructions 1. Use a screen reader (NVDA, JAWS, VoiceOver) to navigate to the homepage 2. Tab to each link and verify the announced text includes external site indication 3. Verify links still function correctly ### Resources - [WCAG 2.4.4 Link Purpose (In Context)](https://www.w3.org/WAI/WCAG21/Understanding/link-purpose-in-context.html) - [MDN: Using aria-label](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label) - [WebAIM: Links and Hypertext](https://webaim.org/techniques/hypertext/) ### Acceptance Criteria - [ ] Links updated with aria-label attributes - [ ] Tested with screen reader (NVDA/JAWS/VoiceOver) - [ ] Keyboard navigation works as expected - [ ] Manual testing completed ---