typo
Separate PR
link-name, scrollable-region-focusable, aria-valid-attr-value, label
many
Engine
coder/docs-engine #220, #217, #224
Fix
Each of the nine screenshots gets alt text that describes what it shows (for example, "Preset dropdown with Ruby Development added between Full Stack and Web Development"), and keeps its caption. The corner cells become "Permission" (Groups and roles), "Component" (air-gapped comparison), "Scenario" (scale-testing workloads) and "Input" (workspace tags). Tables were re-padded with markdown-table-formatter.
QA
Open each production page below. Expected: the screenshots and tables look the same as before, except the four tables now show a word in their top-left header cell.
In Chrome DevTools (Elements) or Firefox's Inspector, select a screenshot on the Add a language page. Expected: its alt differs from the italic caption under it.
Pages to compare
What to check
Production
Preview
Screenshot alt text vs caption
https://coder.com/beta-docs/@main/get-started/customize-your-template/add-a-language/
This PR's GitHub preview: https://github.com/coder/coder/blob/vigilante/docs-a11y-fixes/docs/get-started/customize-your-template/add-a-language.md
Roles table corner cell
https://coder.com/beta-docs/@main/admin/users/groups-roles/
https://github.com/coder/coder/blob/vigilante/docs-a11y-fixes/docs/admin/users/groups-roles.md
Scale-testing table corner cell
https://coder.com/beta-docs/@main/install/validate/scale-testing/
https://github.com/coder/coder/blob/vigilante/docs-a11y-fixes/docs/install/validate/scale-testing.md
Testing
markdownlint-cli2 and markdown-table-formatter over the eight changed files: 0 errors. Re-running the sweep after merge should drop image-redundant-alt and the four tables' empty-table-header findings from @main.
Upstream
No: these are Coder content fixes, not Fumadocs bugs.
Linear: DOCS-1303
🤖 Built with AI assistance.
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:d2509a29-b1b3-926c-0475-f746eec4537e |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | 9810:154D88:135F883:18ABDD6:6B01649B |
| html-safe-nonce | d6d025c58af8a741d7f26f2c34b3994ce29f00c67cf657c946ed5148f41bdd7a |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5ODEwOjE1NEQ4ODoxMzVGODgzOjE4QUJERDY6NkIwMTY0OUIiLCJ2aXNpdG9yX2lkIjoiNTMwMTU0MzE0NzYxNTExODQ5MSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | df36024f1855874f6492734215cb8ff3e2b73f8ac7a432c2532901aa72dee9ae |
| hovercard-subject-tag | pull_request:4877892023 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | ///pull_requests/show/files |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/coder/coder/pull/30873/files |
| twitter:image | https://avatars.githubusercontent.com/u/13631471?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/13631471?s=400&v=4 |
| og:image:alt | Summary
An axe sweep of every page on https://coder.com/beta-docs (coder/docs-engine#224) found two content-side problems. Nine screenshots have alt text identical to the italic caption right after... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/coder/coder git https://github.com/coder/coder.git |
| octolytics-dimension-user_id | 95932066 |
| octolytics-dimension-user_login | coder |
| octolytics-dimension-repository_id | 440752086 |
| octolytics-dimension-repository_nwo | coder/coder |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 440752086 |
| octolytics-dimension-repository_network_root_nwo | coder/coder |
| turbo-body-classes | logged-out env-production page-responsive full-width |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| Skip to content | https://github.com/coder/coder/pull/30873/files#start-of-content |
| https://github.com/ |
| Sign in | https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fcoder%2Fcoder%2Fpull%2F30873%2Ffiles |
| GitHubRepository hosting, code review, and collaboration | https://github.com/platform |
| CopilotAI coding agent for tasks, projects, and automated work | https://github.com/features/copilot |
| ActionsCI/CD and automation | https://github.com/features/actions |
| Code QualityQuality analysis, fixes, and enforcement | https://github.com/features/code-quality |
| CodespacesCloud development environments | https://github.com/features/codespaces |
| Code SecurityVulnerability detection and remediation | https://github.com/security/advanced-security/code-security |
| Secret ProtectionSecret scanning and leak prevention | https://github.com/security/advanced-security/secret-protection |
| All Features | https://github.com/features |
| Documentation | https://docs.github.com/en |
| Training | https://learn.github.com/skills |
| Certifications | https://learn.github.com/credentials |
| Build with Copilot | https://github.com/features/ai |
| Customize Copilot | https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview |
| Integrations | https://github.com/marketplace |
| Trending repos | https://github.com/trending |
| GitHub Sponsors | https://github.com/open-source/sponsors |
| Developer articles | https://github.com/resources/articles |
| ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place. | https://github.blog/changelog/ |
| Enterprises | https://github.com/enterprise |
| Team | https://github.com/team |
| Startups | https://github.com/enterprise/startups |
| Nonprofits | https://github.com/solutions/industry/nonprofits |
| Healthcare | https://github.com/solutions/industry/healthcare |
| Financial services | https://github.com/solutions/industry/financial-services |
| Manufacturing | https://github.com/solutions/industry/manufacturing |
| Government | https://github.com/solutions/industry/government |
| See all industries | https://github.com/solutions/industry |
| Why GitHub | https://github.com/why-github |
| Customer Stories | https://github.com/customer-stories |
| Business insights | https://github.com/solutions/executive-insights |
| Trust Center | https://github.com/trust-center |
| GitHub Advanced SecurityEnterprise-grade code security | https://github.com/security/advanced-security |
| Copilot for businessEnterprise-grade AI features | https://github.com/features/copilot/copilot-business |
| Premium SupportEnterprise-grade 24/7 support | https://github.com/enterprise/premium-support |
| Documentation | https://docs.github.com/en |
| Resource center | https://github.com/resources |
| Blog | https://github.blog/ |
| Events & webinars | https://github.com/resources/events |
| Community Forum | https://github.com/orgs/community/discussions |
| Customer Stories | https://github.com/customer-stories |
| Integrations | https://github.com/marketplace |
| Customer support | https://help.github.com/ |
| Training | https://learn.github.com/skills |
| GitHub Status | https://www.githubstatus.com/ |
| About | https://github.com/about |
| Partners | https://github.com/partners |
| Changelog | https://github.blog/changelog/ |
| GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub. | https://githubuniverse.com/ |
| Pricing | https://github.com/pricing |
| Sign in | https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fcoder%2Fcoder%2Fpull%2F30873%2Ffiles |
| Sign up | https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=coder%2Fcoder |
| Reload | https://github.com/coder/coder/pull/30873/files |
| Reload | https://github.com/coder/coder/pull/30873/files |
| Reload | https://github.com/coder/coder/pull/30873/files |
| coder | https://github.com/coder |
| coder | https://github.com/coder/coder |
| Code | https://github.com/coder/coder |
| Issues320 (320) | https://github.com/coder/coder/issues |
| Pull requests470 (470) | https://github.com/coder/coder/pulls |
| Discussions | https://github.com/coder/coder/discussions |
| Actions | https://github.com/coder/coder/actions |
| Projects | https://github.com/coder/coder/projects |
| Security and quality49 (49) | https://github.com/coder/coder/security |
| Insights | https://github.com/coder/coder/insights |
| Sign up for GitHub
| https://github.com/signup?return_to=%2Fcoder%2Fcoder%2Fissues%2Fnew%2Fchoose |
| terms of service | https://docs.github.com/terms |
| privacy statement | https://docs.github.com/privacy |
| Sign in | https://github.com/login?return_to=%2Fcoder%2Fcoder%2Fissues%2Fnew%2Fchoose |
| nickvigilante | https://github.com/nickvigilante |
| main | https://github.com/coder/coder/tree/main |
| vigilante/docs-a11y-fixes | https://github.com/coder/coder/tree/vigilante/docs-a11y-fixes |
|
Conversation
3
| https://github.com/coder/coder/pull/30873 |
|
Commits
1
| https://github.com/coder/coder/pull/30873/commits |
|
Checks
48
| https://github.com/coder/coder/pull/30873/checks |
|
Files changed
| https://github.com/coder/coder/pull/30873/files |
| Please reload this page | https://github.com/coder/coder/pull/30873/files |
|
docs: give screenshots their own alt text and fill empty table headers
| https://github.com/coder/coder/pull/30873/files#top |
|
Show all changes
1 commit
| https://github.com/coder/coder/pull/30873/files |
|
4864a88
docs: give screenshots their own alt text and fill empty table headers
nickvigilante Oct 15, 2026
| https://github.com/coder/coder/pull/30873/commits/4864a8884d6173a7158fbcc3851c23a3e66dea24 |
|
Clear filters
| https://github.com/coder/coder/pull/30873/files |
| Please reload this page | https://github.com/coder/coder/pull/30873/files |
| Please reload this page | https://github.com/coder/coder/pull/30873/files |
|
README.md
| https://github.com/coder/coder/pull/30873/files#diff-0b5ca119d2be595aa307d34512d9679e49186307ef94201e4b3dfa079aa89938 |
|
workspace-tags.md
| https://github.com/coder/coder/pull/30873/files#diff-1a463f5999eead4f7f46d824fbb21fb8b2e3a1177bec0a8463dd8b210675cde2 |
|
groups-roles.md
| https://github.com/coder/coder/pull/30873/files#diff-a467a85ae1783d7d5f991fed7427f2b37d2a426f51d8aa5217c1b834abacded1 |
|
add-a-language.md
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
authenticate-to-github.md
| https://github.com/coder/coder/pull/30873/files#diff-7f5ab8e9a45b8bd322d3da1a5c423f7a6250f739571447563bc28cc1e80eb55a |
|
index.md
| https://github.com/coder/coder/pull/30873/files#diff-e582a49cb487e9ee236934d0d32fce5abdc3c3e6d59dbe6ce18d682af4b369fd |
|
airgap.md
| https://github.com/coder/coder/pull/30873/files#diff-6bcdcde9b965db4886fa5c83a1205aab66cb00216791db47efcf2a2be7ce9c90 |
|
scale-testing.md
| https://github.com/coder/coder/pull/30873/files#diff-ff82ec0d9439dff2586fe3f768d640326961e63782e9ef484bd5248e896d1c1e |
| docs/README.md | https://github.com/coder/coder/pull/30873/files#diff-0b5ca119d2be595aa307d34512d9679e49186307ef94201e4b3dfa079aa89938 |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/README.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-0b5ca119d2be595aa307d34512d9679e49186307ef94201e4b3dfa079aa89938 |
|
| https://github.com/coder/coder/pull/30873/files#diff-0b5ca119d2be595aa307d34512d9679e49186307ef94201e4b3dfa079aa89938 |
| docs/admin/templates/extending-templates/workspace-tags.md | https://github.com/coder/coder/pull/30873/files#diff-1a463f5999eead4f7f46d824fbb21fb8b2e3a1177bec0a8463dd8b210675cde2 |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/admin/templates/extending-templates/workspace-tags.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-1a463f5999eead4f7f46d824fbb21fb8b2e3a1177bec0a8463dd8b210675cde2 |
|
| https://github.com/coder/coder/pull/30873/files#diff-1a463f5999eead4f7f46d824fbb21fb8b2e3a1177bec0a8463dd8b210675cde2 |
| docs/admin/users/groups-roles.md | https://github.com/coder/coder/pull/30873/files#diff-a467a85ae1783d7d5f991fed7427f2b37d2a426f51d8aa5217c1b834abacded1 |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/admin/users/groups-roles.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-a467a85ae1783d7d5f991fed7427f2b37d2a426f51d8aa5217c1b834abacded1 |
|
| https://github.com/coder/coder/pull/30873/files#diff-a467a85ae1783d7d5f991fed7427f2b37d2a426f51d8aa5217c1b834abacded1 |
| docs/get-started/customize-your-template/add-a-language.md | https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/get-started/customize-your-template/add-a-language.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6e50b41463ac2c45fe25a02bbd87219eae9c24c7331a3c05ea51a5f79f49c976 |
| docs/get-started/customize-your-template/authenticate-to-github.md | https://github.com/coder/coder/pull/30873/files#diff-7f5ab8e9a45b8bd322d3da1a5c423f7a6250f739571447563bc28cc1e80eb55a |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/get-started/customize-your-template/authenticate-to-github.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-7f5ab8e9a45b8bd322d3da1a5c423f7a6250f739571447563bc28cc1e80eb55a |
|
| https://github.com/coder/coder/pull/30873/files#diff-7f5ab8e9a45b8bd322d3da1a5c423f7a6250f739571447563bc28cc1e80eb55a |
|
| https://github.com/coder/coder/pull/30873/files#diff-7f5ab8e9a45b8bd322d3da1a5c423f7a6250f739571447563bc28cc1e80eb55a |
| docs/get-started/customize-your-template/index.md | https://github.com/coder/coder/pull/30873/files#diff-e582a49cb487e9ee236934d0d32fce5abdc3c3e6d59dbe6ce18d682af4b369fd |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/get-started/customize-your-template/index.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-e582a49cb487e9ee236934d0d32fce5abdc3c3e6d59dbe6ce18d682af4b369fd |
|
| https://github.com/coder/coder/pull/30873/files#diff-e582a49cb487e9ee236934d0d32fce5abdc3c3e6d59dbe6ce18d682af4b369fd |
| docs/install/prepare/airgap.md | https://github.com/coder/coder/pull/30873/files#diff-6bcdcde9b965db4886fa5c83a1205aab66cb00216791db47efcf2a2be7ce9c90 |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/install/prepare/airgap.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-6bcdcde9b965db4886fa5c83a1205aab66cb00216791db47efcf2a2be7ce9c90 |
|
| https://github.com/coder/coder/pull/30873/files#diff-6bcdcde9b965db4886fa5c83a1205aab66cb00216791db47efcf2a2be7ce9c90 |
| docs/install/validate/scale-testing.md | https://github.com/coder/coder/pull/30873/files#diff-ff82ec0d9439dff2586fe3f768d640326961e63782e9ef484bd5248e896d1c1e |
|
View file
| https://github.com/coder/coder/blob/4864a8884d6173a7158fbcc3851c23a3e66dea24/docs/install/validate/scale-testing.md |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/coder/coder/pull/30873/{{ revealButtonHref }} |
|
| https://github.com/coder/coder/pull/30873/files#diff-ff82ec0d9439dff2586fe3f768d640326961e63782e9ef484bd5248e896d1c1e |
|
| https://github.com/coder/coder/pull/30873/files#diff-ff82ec0d9439dff2586fe3f768d640326961e63782e9ef484bd5248e896d1c1e |
| Please reload this page | https://github.com/coder/coder/pull/30873/files |
|
| https://github.com |
| Terms | https://docs.github.com/site-policy/github-terms/github-terms-of-service |
| Privacy | https://docs.github.com/site-policy/privacy-policies/github-privacy-statement |
| Security | https://github.com/security |
| Status | https://www.githubstatus.com/ |
| Community | https://github.community/ |
| Docs | https://docs.github.com/ |
| Contact | https://support.github.com?tags=dotcom-footer |
.