Uh oh!
There was an error while loading. Please reload this page.
docs: document the widget subCaption translation key - #8395
Merged
Conversation
The "What you can translate" table's dashboard row only ever said `dashboards.<name>` — it never enumerated the widget node's keys, so authors had no way to learn `subCaption` (added by #7862 for the metric widget's sub-caption, `options.description`) from the guide. Split the row into a dashboard-level row and a widget row listing `title` / `description` / `subCaption`, and add a callout explaining that a widget's `subtitle` alias now resolves to `subCaption`, not `description` — two different authored fields, two keys, per the #5428 item-4 ruling. Part of #8052 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Jqe56GnYFddggeAyfkZFVz
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
qq9340100
marked this pull request as ready for review
August 13, 2026 11:18
Uh oh!
There was an error while loading. Please reload this page.
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 freeto 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.
Fixes#8052
Adds the dashboard widget node's
subCaptiontranslation key tocontent/docs/ui/translations.mdx(follow-up to #7862, which landed the keyon
mainwithout a docs update).What changed
dashboards.{name}row neverenumerated the widget node's own keys. Split it into a dashboard-level row
(
label/description) and a widget row listing all three members:title/description/subCaption(
dashboards.{name}.widgets.{widgetId}.*).subtitlealias now resolves tosubCaption, notdescription— the metric widget's sub-caption(
options.description) is a different authored field from the widget's owndescription, so each gets its own key per the objectui: dashboard KPI cards drop the translated widget title/description — the self-containedmetricpath bypassestWidgetTitle, and the plugin's privateresolveLabelnever callst()#5428 item-4 ruling(「两个作者字段两个 key」).
prose per the unlock comment's warning — the table row was the only mention
of widgets in the file, so no second edit site existed.
Not touched
content/docs/references/system/translation.mdx(the generated reference)needed no change — it truncates the widget node's inner shape at
object,verified unchanged on this branch.
Verification
pnpm check:docs-audit-scope— passpnpm check:quick-reference-counts— passpnpm check:role-word— passpnpm --filter @objectstack/lint run check:doc-formula-expressions— pass(after
pnpm --filter '@objectstack/lint^...' build, needed once in afresh worktree for
@objectstack/formula's dist output)pnpm check:nul-bytes— passnode scripts/pm/dispatch-gates.mjs content/docs/ui/translations.mdx— samefour families, no additional family surfaced.
Generated by Claude Code
Generated by Claude Code