Maniphest T361994

Improve and phrase alternative text consistently
Closed, ResolvedPublic2 Estimated Story Points
Actions

Assigned To

Authored By

	Volker_E
	Sat, Apr 6, 7:47 AM

Tags

Referenced Files

None

Subscribers

Description

Background

Currently, as of v1.3.6, we're approaching alternative texts differently across our documentation.

Goal

For a better experience for assistive technology users we should

remove prefixes like “an example of”, “a screenshot of”
remove “components” suffixes, as it's clear out of context and we're not consistently adding them
add punctuation to alt texts consistently, it's recommended

Wrong ❌	Ok ✅
A screenshot of two accordions with an InfoChip adjacent to their labels.	Two Accordions with an InfoChip adjacent to their labels.

Acceptance criteria for done

Amend documentation accordingly

Details

	Subject	Repo	Branch	Lines +/-
	Update Codex from 1.3.6 to 1.4.0	mediawiki/core	master	+190 -114
	docs: Unify alternative text across documentation	design/codex	main	+222 -222

Customize query in gerrit

Event Timeline

Volker_E created this task.Sat, Apr 6, 7:47 AM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptSat, Apr 6, 7:47 AM

Change #1017423 had a related patch set uploaded (by VolkerE; author: VolkerE):

[design/codex@main] docs: Unify alternative text across documentation

https://gerrit.wikimedia.org/r/1017423

gerritbot added a project: Patch-For-Review.Sat, Apr 6, 7:49 AM

Aklapper added projects: Codex, Design-System-Team.Sat, Apr 6, 12:21 PM

bmartinezcalvo updated the task description. (Show Details)Thu, Apr 11, 9:35 AM

bmartinezcalvo updated the task description. (Show Details)Thu, Apr 11, 9:37 AM

CCiufo-WMF moved this task from Inbox to Up Next on the Design-System-Team board.Thu, Apr 11, 3:17 PM

Volker_E claimed this task.Thu, Apr 11, 10:09 PM

Volker_E set the point value for this task to 2.

Volker_E edited projects, added Design-System-Team (DST-Sprint-20 (2024-04-01 to 2024-04-12)); removed Design-System-Team.

Volker_E moved this task from Committed to Code Review on the Design-System-Team (DST-Sprint-20 (2024-04-01 to 2024-04-12)) board.

Change #1017423 merged by jenkins-bot:

[design/codex@main] docs: Unify alternative text across documentation

https://gerrit.wikimedia.org/r/1017423

Volker_E removed a project: Patch-For-Review.Tue, Apr 16, 5:57 PM

Volker_E updated the task description. (Show Details)

Volker_E moved this task from Code Review to Pending Release on the Design-System-Team (DST-Sprint-20 (2024-04-01 to 2024-04-12)) board.

Change #1020918 had a related patch set uploaded (by Eric Gardner; author: Eric Gardner):

[mediawiki/core@master] Update Codex from 1.3.6 to 1.4.0

https://gerrit.wikimedia.org/r/1020918

gerritbot added a project: Patch-For-Review.Wed, Apr 17, 8:40 PM

Change #1020918 merged by jenkins-bot:

[mediawiki/core@master] Update Codex from 1.3.6 to 1.4.0

https://gerrit.wikimedia.org/r/1020918

egardner closed this task as Resolved.Wed, Apr 17, 10:25 PM

Maintenance_bot removed a project: Patch-For-Review.Fri, Apr 26, 6:00 PM