Summary
Rename the table's "Description" column to "Caption" — the term Commons / SDC actually uses for the short-label field — and enforce Commons' caption rules (length limit, character restrictions, language tagging). Surface clear error messages on violations and a tooltip that explains what makes a good caption.
Research first
Look up Commons / Wikidata documentation for SDC captions (a.k.a. labels in Wikibase / mw.cs.label / Special:MediaSearch). Confirm and document in the task:
- Length limit — believed to be ~250 characters; verify the exact limit and whether it's enforced server-side, client-side, or both.
- Character restrictions — line breaks, HTML, wikitext, links: which are stripped / disallowed?
- Language tag — captions are per-language; what's the storage format the API expects?
- Multilingual captions — note the relationship to T425864's "Add language" placeholder for the Description column. Coordinate with that work if relevant.
Implementation
- Rename the Description column header to Caption everywhere in the UI (header, columns modal, settings dropdown, etc.).
- Add a client-side validator on the cell editor that:
- Blocks / warns on length-limit violations (live character count visible to the user, like a short-form textarea pattern).
- Strips or warns on disallowed characters.
- Inline error message immediately below the cell when validation fails; clear actionable wording (e.g. "Captions must be ≤ 250 characters — you have 312.").
- Tooltip on the column header (and/or an info icon) summarising "what makes a good caption" — short, plain-language guidance with a link to Commons' caption help page.
Out of scope
- The longer-form file Description (the one stored in the wikitext description= field) — captions and descriptions are different fields on Commons; this task is about the SDC caption.
- Multilingual caption editing (T425864 placeholder).
Acceptance
- Column header reads "Caption" everywhere.
- Typing past the length limit shows a clear error and prevents publish.
- Hover / info icon shows the caption-writing guidance.
- The validator's behaviour matches what the documented Commons / SDC limits actually are.
Source
User feedback session, 2026-05-10.