== 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.