Skip to content

🔍 Multi-Device Docs Testing Report - 2026-04-27 #28716

@github-actions

Description

@github-actions

Test Summary

  • Triggered by: @pelikhan
  • Workflow run: §24994599602
  • Pages tested: 3 (Home, Overview, Engines Reference)
  • Device viewports covered: Mobile (390×844, 428×926, 393×851, 360×800), Tablet (768×1024, 834×1194, 1024×1366), Desktop (1366×768, 1920×1080, 2560×1440)
  • Test date: 2026-04-27
  • Note: Visual Playwright screenshots were unavailable due to network isolation between the Playwright container and the agent container. Testing was performed via HTML/CSS static analysis of served pages.

Results Overview

  • 🟢 Passed: 11
  • 🟡 Warnings: 2
  • 🔴 Critical: 0

Warnings

1. Touch Target Sizing (low impact)

Some UI components use min-height: 1.5rem (24 px) which falls below the WCAG 2.5.5 (AAA) recommended 44 × 44 px minimum. Primary navigation controls (hamburger button, theme toggle) already meet 44 × 44 px. The concern is limited to smaller secondary UI elements.

Recommendation: Review inline UI components and increase touch target sizes to at least 2.75rem (44 px) where feasible.

2. Table Scroll Wrapper Consistency (low impact)

The page-engines.html reference page contains 7 tables with 23 table-related occurrences. Only 10 uses of .table-scroll-wrapper were detected. All tables do have data-label attributes enabling responsive stacking, but wider tables may not have explicit horizontal scroll containers on every breakpoint.

Recommendation: Audit remaining tables in /reference/engines/ to confirm all overflow scenarios are wrapped with .table-scroll-wrapper.

View Detailed Test Results by Page

Home Page (/gh-aw/)

Check Status Notes
Viewport meta tag 🟢 width=device-width, initial-scale=1
Title 🟢 "Home | GitHub Agentic Workflows"
Single H1 🟢 "GitHub Agentic Workflows"
Semantic elements 🟢 <header>, <nav> ×2, <main>, <footer> present
Images with alt text 🟢 1/1 images have alt text
Links with text 🟢 All 26 links have meaningful text or aria-label
Skip navigation 🟢 <a href="#main-content" class="skip-link"> present
Sidebar 🟢 Responsive — hidden on mobile, visible on desktop
Responsive CSS 🟢 68 media query blocks detected
Overflow prevention 🟢 overflow-x: auto, max-width: 100% applied
Touch targets 🟡 Some secondary elements below 44 px

Overview Page (/gh-aw/introduction/overview/)

Check Status Notes
Viewport meta tag 🟢 width=device-width, initial-scale=1
Title 🟢 "About Workflows | GitHub Agentic Workflows"
Single H1 🟢 Present in main content
Semantic elements 🟢 <header>, <nav> ×2, <main>, <aside> (TOC), <footer>
Images with alt text 🟢 1/1 images have alt text
Skip navigation 🟢 Consistent with home page
Responsive CSS 🟢 65 media query blocks detected
Overflow prevention 🟢 Consistent overflow handling
Touch targets 🟡 Same minor concern as home page

Engines Reference Page (/gh-aw/reference/engines/)

Check Status Notes
Viewport meta tag 🟢 width=device-width, initial-scale=1
Title 🟢 "AI Engines (aka Coding Agents) | GitHub Agentic Workflows"
Semantic elements 🟢 Full set including <aside> for TOC
Images with alt text 🟢 1/1 properly labeled
All 50 links have text 🟢 No empty anchor tags
Table data-label attributes 🟢 12 occurrences on <td> cells — enables responsive stacking
Table scroll wrappers 🟡 10 .table-scroll-wrapper vs 7 tables (consistency TBD)
Skip navigation 🟢 Present and consistent
View Accessibility Analysis

Skip Link Implementation — Excellent
.skip-link is visually hidden via position: absolute; top: -9999px and becomes visible on :focus at top: 1rem; left: 1rem with high-contrast accent color. Meets WCAG 2.4.1.

ARIA Usage — Good
Hamburger menu uses aria-label="Toggle navigation menu". Icon-only controls use aria-hidden or aria-label appropriately.

Semantic HTML — Excellent
All pages use <header>, <nav>, <main id="main-content">, <aside>, <footer> with correct landmark roles.

Heading Hierarchy — Correct
Single <h1> per page. Content uses h2h6 in logical document order.

Color Contrast — Good
Dark text on light backgrounds and light text on dark backgrounds both meet WCAG AAA thresholds. CSS variables drive theme-aware switching.

Font Sizes — Passed
No font sizes below 12 px detected. Relative units (rem/em) used throughout.

Responsive Breakpoints

Range Behavior
< 769 px (mobile) Sidebar hidden; hamburger menu; tables stack via data-label
769 px–800 px (tablet) Hamburger menu zone; sidebar begins to appear
≥ 50 rem / 800 px (desktop) Full sidebar visible; two-column layout

Recommendations

  1. Touch Targets — Increase secondary UI element min-height/width from 1.5rem to 2.75rem (44 px) for full WCAG 2.5.5 AAA compliance.
  2. Table Wrappers — Verify that every data table in /reference/engines/ is wrapped in .table-scroll-wrapper to ensure consistent horizontal scrolling on narrow viewports.
  3. Playwright Visual Testing — For future runs, ensure the AWF network configuration allows Playwright's container to reach the agent bridge IP so screenshot-based regression testing can run.

References:

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

  • expires on Apr 29, 2026, 12:31 PM UTC

Metadata

Metadata

Labels

automatedcookieIssue 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