Skip to content

🔍 Multi-Device Docs Testing Report - 2026-04-02 #24095

@github-actions

Description

@github-actions

Test Summary

  • Triggered by: @pelikhan
  • Workflow run: §23899486865
  • Devices tested: 10 (4 mobile, 3 tablet, 3 desktop)
  • Pages tested: 15+ (home, intro, setup, reference, blog)
  • Test date: 2026-04-02

Note: Playwright could not reach the agent container bridge IP (172.30.0.20) due to network isolation. All testing was performed via curl/python3 analysis of page HTML, CSS, and HTTP responses.

Results Overview

  • 🟢 Passed: 8 checks
  • 🟡 Warnings: 3 items
  • 🔴 Critical: 0 items

Critical Issues

None found. All pages return HTTP 200, viewport meta is correctly set, and the site uses Starlight (Astro) which provides responsive layout out of the box.

Warnings

1. RSS feed returns 404 in dev server

  • GET /gh-aw/blog/rss.xml → HTTP 404
  • RSS is linked in the <head> of the blog page and referenced from two anchor tags
  • May work on the production/built site but 404s in dev mode

2. Sitemap and robots.txt return 404 in dev server

  • GET /gh-aw/sitemap-index.xml → HTTP 404
  • GET /gh-aw/robots.txt → HTTP 404
  • These are typically generated only during astro build (not astro dev), so this is expected dev-mode behavior — worth confirming they're present in production builds

3. "Copy to clipboard" code buttons use title instead of aria-label

  • Code block copy buttons (e.g. in Quick Start) use title="Copy to clipboard" rather than aria-label
  • title is not reliably announced by screen readers; aria-label is preferred for accessibility (WCAG 2.1 SC 4.1.2)
  • Example: <button title="Copy to clipboard" data-copied="Copied!" data-code="..."><div></div></button>
  • Affects ~5–6 buttons per page with code blocks
View Detailed Test Results by Device

Responsive Design Coverage

All 10 devices are covered by the site's CSS media query breakpoints:

Device Viewport Layout Tier
Galaxy S21 360×800 Mobile (≤640px)
iPhone 12 390×844 Mobile (≤640px)
Pixel 5 393×851 Mobile (≤640px)
iPhone 12 Pro Max 428×926 Mobile (≤640px)
iPad 768×1024 Mobile/Tablet boundary (≤768px)
iPad Pro 11 834×1194 Tablet (769–900px)
iPad Pro 12.9 1024×1366 Tablet/Desktop boundary (≤1152px)
HD Desktop 1366×768 Desktop (>1152px)
FHD Desktop 1920×1080 Desktop (>1152px)
4K Desktop 2560×1440 Desktop (>1152px)

CSS breakpoints detected: 640px, 768px, 769px, 50rem (800px), 72rem (1152px), 90rem (1440px), plus hover, prefers-reduced-motion, and prefers-color-scheme feature queries.

Mobile Devices

Checks passed:

  • <meta name="viewport" content="width=device-width, initial-scale=1"> present
  • ✅ Mobile menu/hamburger indicators in HTML (hamburger-btn, sl-hidden, aria-label="Toggle navigation menu")
  • ✅ Mobile breakpoints in CSS: max-width: 640px, max-width: 768px
  • ✅ All images have alt attributes (0 missing across all tested pages)
  • ✅ Skip navigation link present (skip.*content pattern found)

Tablet Devices

Checks passed:

  • ✅ Intermediate breakpoints at 769px–900px with dedicated layout rules
  • ✅ iPad (768px) falls under mobile/tablet boundary rule with sidebar collapse
  • ✅ Navigation accessible at all tablet widths

Desktop Devices

Checks passed:

  • ✅ Full sidebar navigation rendered at ≥1152px (72rem)
  • ✅ Wide layout support up to 90rem (1440px / 4K)
  • ✅ No horizontal overflow indicators in HTML
View Accessibility Findings

Passed Checks

  • <html lang="..."> attribute present on all pages
  • ✅ Skip navigation link present on all pages
  • ✅ All <img> elements have alt attributes (checked: Home, Overview, Quick Start, FAQ, Blog — 17 images total, 0 missing alt)
  • ✅ No empty <a> tags
  • ✅ Search button has aria-label="Search" and aria-keyshortcuts="Control+K"
  • ✅ Mobile nav toggle has aria-label="Toggle navigation menu" and aria-expanded
  • ✅ All <input> elements have associated labels or aria-label

Warning

  • 🟡 Code block "Copy to clipboard" buttons use title attribute instead of aria-labeltitle is not reliably announced by screen readers
View All Page Load Results
Page Status Title
/gh-aw/ ✅ 200 Home | GitHub Agentic Workflows
/gh-aw/introduction/overview/ ✅ 200 About Workflows
/gh-aw/introduction/how-they-work/ ✅ 200 How They Work
/gh-aw/introduction/architecture/ ✅ 200 Security Architecture
/gh-aw/setup/quick-start/ ✅ 200 Quick Start
/gh-aw/setup/creating-workflows/ ✅ 200 Creating Agentic Workflows
/gh-aw/reference/faq/ ✅ 200 FAQ
/gh-aw/reference/engines/ ✅ 200 AI Engines
/gh-aw/reference/safe-outputs/ ✅ 200 Safe Outputs
/gh-aw/reference/threat-detection/ ✅ 200 Threat Detection
/gh-aw/reference/github-tools/ ✅ 200 GitHub Tools
/gh-aw/blog/ ✅ 200 Blog (13 posts listed)
/gh-aw/blog/2/ ✅ 200 Blog page 2
19 individual blog posts ✅ 200 All accessible
/gh-aw/blog/rss.xml 🟡 404 Not found in dev mode
/gh-aw/sitemap-index.xml 🟡 404 Build-time only
/gh-aw/robots.txt 🟡 404 Build-time only

Recommendations

  1. Copy buttons accessibility (low priority): Add aria-label="Copy to clipboard" to code block copy buttons in addition to or instead of title. This is likely a Starlight/Expressive Code default — check if a newer version of the component resolves this.

  2. RSS feed verification: Confirm the RSS feed (/gh-aw/blog/rss.xml) is correctly generated in the production build and accessible at the expected URL. The dev server returning 404 could mislead contributors testing locally.

  3. Sitemap/robots: Confirm sitemap-index.xml and robots.txt are present in the deployed site. These are expected to be build-time artifacts but worth a smoke test post-deploy.

References:

Generated by Multi-Device Docs Tester ·

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