Skip to content

🔍 Multi-Device Docs Testing Report - 2026-04-05 #24725

@github-actions

Description

@github-actions

Test Summary

  • Triggered by: @pelikhan
  • Workflow run: §24001031705
  • Devices tested: 10 (4 mobile, 3 tablet, 3 desktop)
  • Test date: 2026-04-05
  • Note: Playwright browser connectivity was unavailable (network isolation); testing performed via server-side HTML/CSS static analysis

Results Overview

  • 🟢 Passed: 44 checks across 4 key pages
  • 🟡 Warnings: 4 minor observations
  • 🔴 Critical: 0

Critical Issues

No critical issues found. All pages pass structural and accessibility requirements.

View All Warnings
Warning Severity Notes
overflow-x: hidden on body Low Applied to <html> element — may mask horizontal overflow issues on very small screens if CSS changes introduce them in the future. Not currently causing visible problems.
Sitemap returns 404 in dev mode Info /gh-aw/sitemap-index.xml returns 404 during astro dev. This is expected — Astro only generates the sitemap at build time. No action needed.
No print media query Low No @media print stylesheet detected. Minor usability gap for users who print documentation.
No breadcrumb navigation Low Deep reference pages (e.g. /gh-aw/reference/frontmatter/) lack breadcrumbs. May make orientation harder on mobile. Starlight's prev/next navigation is present as a partial substitute.
View Detailed Test Results by Device

Mobile Devices (all 390–428px wide)

All four mobile device sizes fall below the 640px CSS breakpoint, activating the mobile-compact layout with hamburger navigation.

Device Size Layout Nav
iPhone 12 390×844 mobile-compact hamburger
iPhone 12 Pro Max 428×926 mobile-compact hamburger
Pixel 5 393×851 mobile-compact hamburger
Galaxy S21 360×800 mobile-compact hamburger

🟢 Hamburger menu has aria-expanded attribute for screen reader state announcement.

Tablet Devices

Device Size Layout Nav
iPad 768×1024 tablet (768px breakpoint) hamburger
iPad Pro 11 834×1194 tablet-expanded (769–900px) hamburger
iPad Pro 12.9 1024×1366 desktop (>900px) full sidebar

🟢 iPad Pro 12.9 at 1024px crosses the 900px breakpoint and renders with the full desktop sidebar layout.

Desktop Devices

Device Size Layout Nav
HD 1366×768 desktop full sidebar
FHD 1920×1080 desktop full sidebar
4K 2560×1440 desktop full sidebar

🟢 All desktop sizes use the full sidebar layout. No fixed-width elements that could cause layout breakage at 4K.

Accessibility Findings

All pages tested (home, blog, reference/frontmatter, guides/getting-started-mcp) passed key accessibility checks:

  • <html lang="en"> on all pages
  • ✅ Responsive viewport meta tag on all pages
  • ✅ Skip-navigation link present on all pages
  • ✅ Single <h1> per page, correct heading hierarchy (h1 → h2 → h3 → h4)
  • ✅ All images have alt attributes
  • ✅ ARIA labels on interactive elements (6–19 per page)
  • aria-expanded on mobile hamburger menu
  • aria-current for active navigation item
  • ✅ Focus-visible styles present
  • ✅ Semantic landmark elements: <header>, <nav>, <main>, <footer>
  • prefers-reduced-motion respected
  • ✅ Dark mode support via prefers-color-scheme + manual theme switcher

Recommendations

  1. Consider adding breadcrumbs to deep reference pages to aid orientation, especially on mobile. Starlight supports a [breadcrumbs option]((starlight.astro.build/redacted) in the sidebar config.
  2. Document the sitemap dev-mode limitation in contributor docs if CI pipelines check for the sitemap URL during local preview.
  3. No action required for the other warnings — they are low-priority or expected behaviors.

References:

Generated by Multi-Device Docs Tester · ● 300.6K ·

  • expires on Apr 7, 2026, 12:05 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