fix(a11y): add missing alt text to Talk and KDE sync images#14836
Merged
Conversation
Images without :alt: attributes cause Sphinx to fall back to the file path as alt text (e.g. "../_images/foo.png"), which is meaningless to screen readers and fails WCAG 1.1.1 / BITV 9.1.1.1. Add descriptive :alt: text to 135 image directives across: - user_manual/talk/ (all major sections: conversations, messages, calls, chat, guests, attachments, call recording, breakout rooms, call views, federation, files integration, calendar integration, appearance, bots, matterbridge, message integrations, webinar) - user_manual/groupware/sync_kde.rst Partial fix for #9663 — remaining images in other manuals and sections will be addressed in follow-up contributions. Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
skjnldsv
requested review from
Antreesy,
DorraJaouad and
nickvergessen
as code owners
Contributor
AndyScherzinger
approved these changes
May 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
☑️ Resolves
🖼️ Screenshots
Images without
:alt:attributes cause Sphinx to fall back to the file path (e.g.../_images/foo.png) as the renderedaltvalue, which is meaningless to screen readers and fails WCAG 1.1.1 / BITV 9.1.1.1.This PR adds descriptive
:alt:text to 135 image directives across the user manual Talk section and the KDE sync guide:user_manual/talk/— conversations, messages, calls, chat, guests, attachments, call recording, breakout rooms, call views, federation, files integration, calendar integration, appearance, bots, matterbridge, message integrations, webinaruser_manual/groupware/sync_kde.rstRemaining images in other manuals and sections (admin manual, other groupware pages) will be addressed in follow-up contributions.
✅ Checklist
codespellor similar and addressed any spelling issues