Skip to content

πŸ” Multi-Device Docs Testing Report - 2026-04-20Β #27336

@github-actions

Description

@github-actions

Test Summary

  • Triggered by: @pelikhan
  • Workflow run: Β§24665827026
  • Devices tested: 10 (4 mobile, 3 tablet, 3 desktop) via HTML/CSS analysis + user-agent simulation
  • Pages tested: 8
  • Test date: 2026-04-20

Note on Playwright: The browser automation container could not reach the docs server (known network isolation constraint). Testing was performed via curl + HTML analysis across all device contexts. Visual screenshots were unavailable; layout was assessed through CSS media query inspection and responsive metadata.

Results Overview

  • 🟒 Passed: 71 accessibility/responsive checks across 8 pages
  • 🟑 Warnings: 3 accessibility issues found
  • πŸ”΄ Critical: 0

Warnings Found

1. Generic "here" link text on video fallback links (Homepage)

  • Two <video> elements on the homepage include fallback download links with non-descriptive anchor text: <a href="...mp4">here</a>
  • This violates WCAG 2.4.4 (Link Purpose) β€” screen readers announce "here" without context
  • Fix: Replace with descriptive text, e.g. <a href="...">Download install demo video</a>

2. Videos missing captions/tracks (Homepage)

  • Both <video> elements on the homepage have no <track> element for captions or subtitles
  • This affects deaf/hard-of-hearing users (WCAG 1.2.2 Captions β€” Prerecorded)
  • Fix: Add <track kind="captions" src="..." srclang="en" label="English"> to each video, or add a transcript

3. Sitemap 404

  • /gh-aw/sitemap-index.xml returns HTTP 404 (linked from homepage HTML)
  • This may be a dev-server artifact (sitemaps are often build-only), but worth verifying
View All Checks Passed

All 8 pages passed the following checks:

  • βœ… Viewport meta tag (width=device-width, initial-scale=1)
  • βœ… Single <h1> per page with correct heading hierarchy
  • βœ… <main> landmark present
  • βœ… <nav> landmark present
  • βœ… Skip-to-content link (WCAG 2.4.1 β€” enhanced implementation)
  • βœ… lang="en" on <html> element
  • βœ… UTF-8 charset declared
  • βœ… Meta description on all pages
  • βœ… Open Graph (og:title) on all pages
  • βœ… Dark mode support (data-theme + prefers-color-scheme)
  • βœ… Print CSS included
  • βœ… ARIA labels present throughout
  • βœ… Search functionality present
  • βœ… Mobile hamburger/responsive nav toggle present
  • βœ… Responsive CSS breakpoints: 640px, 768px (mobile), 769px+ (desktop)
  • βœ… 24/25 internal navigation links return HTTP 200
  • βœ… Server returns HTTP 200 for all device user-agents (Mobile Safari, Chrome Android, iPad, Desktop Chrome)
View Detailed Test Results by Device

Mobile Devices (390–428px width)

All mobile devices received correct HTML with responsive viewport meta and mobile-specific CSS breakpoints. Hamburger/mobile-nav toggle confirmed present. No horizontal overflow indicators in CSS.

Device Viewport Status
iPhone 12 390Γ—844 🟒 Layout OK (HTML analysis)
iPhone 12 Pro Max 428Γ—926 🟒 Layout OK (HTML analysis)
Pixel 5 393Γ—851 🟒 Layout OK (HTML analysis)
Galaxy S21 360Γ—800 🟒 Layout OK (HTML analysis)

Tablet Devices (768–1024px width)

CSS breakpoints at 769px trigger desktop layout transitions. Responsive grid detected for 768px cutover.

Device Viewport Status
iPad 768Γ—1024 🟒 Layout OK (HTML analysis)
iPad Pro 11 834Γ—1194 🟒 Layout OK (HTML analysis)
iPad Pro 12.9 1024Γ—1366 🟒 Layout OK (HTML analysis)

Desktop Devices (1366–2560px width)

All desktop widths served identical HTML; CSS handles layout via min-width: 72rem and min-width: 50rem breakpoints.

Device Viewport Status
HD (1366Γ—768) 1366Γ—768 🟒 Layout OK (HTML analysis)
FHD (1920Γ—1080) 1920Γ—1080 🟒 Layout OK (HTML analysis)
4K (2560Γ—1440) 2560Γ—1440 🟒 Layout OK (HTML analysis)
View Performance Notes
  • HTML page size: 225 KB β€” large for a documentation page; mostly inline CSS/JS from Astro dev server (build output will be significantly smaller)
  • External scripts: 65 (Vite module splitting in dev mode; expected to bundle in production)
  • Lazy loading: Images do not use loading="lazy" β€” minor optimization opportunity
  • Preload hints: 2 resource preloads configured βœ…

Accessibility Findings

Issue WCAG Criterion Severity Location
Generic "here" link text 2.4.4 Link Purpose 🟑 Warning Homepage β€” 2 video fallback links
Videos missing captions 1.2.2 Captions (Prerecorded) 🟑 Warning Homepage β€” 2 <video> elements
Sitemap link 404 N/A 🟑 Warning Homepage HTML (dev-server artifact likely)

Recommendations

  1. Update video fallback links: Change <a href="...">here</a> β†’ <a href="...">Download [video name]</a> in the homepage video components
  2. Add video captions or transcripts: Either add <track> elements with WebVTT caption files, or add a text transcript adjacent to each video
  3. Verify sitemap: Confirm sitemap-index.xml is generated in the build and the link is only rendered when the file exists

References:

Generated by Multi-Device Docs Tester Β· ● 350.5K Β· β—·

  • expires on Apr 22, 2026, 12:22 PM UTC

Metadata

Metadata

Labels

cookieIssue Monster Loves Cookies!documentationImprovements or additions to documentationtesting

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions