docs: add alt text to 157 images on the top 20 files

[VeronicaSnyk]

Group B item 7 of the September 2026 AI-readiness audit.

480 images across 167 files have no alt text. This PR covers the 20 files with the most — 157 images, roughly a third of the backlog — which is the scope the audit recommended.

Where the text comes from

94 of the 157 images already had a <figcaption> describing them. That text is author-written and already reviewed, so it is reused as the alt text rather than replaced with something new.

The remaining 63 are written from the page's own heading and surrounding prose. Nothing is asserted about a screenshot beyond what the page already states — where the page says "Click Configure MCP Servers on the MCP Servers tab", the alt text is "Configure MCP Servers button on the MCP Servers tab".

Two groups that needed individual treatment

Most images follow a pattern. Two sets do not, because they are inline icons in lookup tables where each image means something different and generic alt text would actively mislead:

assets-inventory-components.md — six coverage control logos, each a different state:

alt="Control logo: the Snyk product was executed"
alt="Control logo: the Snyk product was executed but with issues"
alt="Control logo: the Snyk product should have been executed but was not"
...

run-an-analysis-with-the-jetbrains-plugin.md — four severity icons, named individually: Critical, High, Medium, Low.

In both cases the meaning was taken from the adjacent table cell.

Verification

• All 20 files now pass tools/alt-text-check (the check added in docs: AI-readiness Group A fixes #1725)
• 157 lines changed, one per image, with zero lines differing beyond the alt text — verified by normalising the alt slot on both sides of the diff and comparing the remainder
• Both image syntaxes handled: HTML alt="" and Markdown ![](

Scope note

This is the top 20 files. 323 images across 147 files remain, mostly one or two per page. Worth doing in a follow-up once the voice here is confirmed.

Per the audit: imprecise alt text still beats none, so review should not become the bottleneck. That said, the 63 inferred descriptions are the ones worth a skim — a reviewer who knows the screenshots will spot anything off faster than I can.

---

Note

Low Risk
Documentation-only accessibility edits to image alt attributes; no runtime, auth, or security logic is modified.

Overview
Adds descriptive alt text to 157 screenshots and icons across the 20 documentation pages with the largest missing-alt backlog (agent quickstarts, IDE auth/scan guides, GitHub Server App, webhooks/Zapier tutorials, analytics reports, and related topics).

Most updates fill empty alt="" attributes on <figure><img> tags or add alt strings to Markdown ![]() images. Where a <figcaption> already existed, that text is copied into alt; otherwise descriptions are taken from nearby headings and steps (for example MCP setup in Cline/Copilot/Devin).

Two lookup-table exceptions get state-specific alt text instead of generic labels: the six asset inventory coverage control icons and the four JetBrains severity icons in table cells.

No product behavior, APIs, or config defaults change—only documentation accessibility for screen readers and the alt-text audit check.

^{Reviewed by Cursor Bugbot for commit 78325e3. Bugbot is set up for automated code reviews on this repo. Configure here.}

[snyk-io]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues
✅	Code Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[cursor]

AI review

No style or structural issues found.

Verified: all 157 added alt texts provide descriptive labels for images across the top 20 pages · alt text style complies with Snyk writing guidelines (no contractions, no Latin abbreviations, active descriptions) · table formatting and figure captions remain intact.

The current head commit 78325e306a2af7e7c7360a07db342536acdd65a1 is reviewed.

  

_{Sent by Cursor Automation: PR review for User Docs}