From 6c463cec86f9888920cc3341103add113c49b99c Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Tue, 29 Sep 2026 12:10:45 +0000
Subject: [PATCH] fix(lint): state the react-prop-deprecated warning's reason
 in words, not a tracker number

The react-prop-deprecated finding message ended by citing a tracker number
that no longer resolves. It now says what that decision was: the react tier
converges on the metadata-tier vocabulary, so the deprecated spelling keeps
working through the deprecation window and is removed after it. The tag, prop
and replacedBy interpolations are unchanged, as are the rule id, severity and
hint.

The sibling-package prose-id baseline shrinks by exactly that one pinned site,
regenerated with the gate's own --census-ledger.

Claude-Session: https://claude.ai/code/session_014EJ1ED8X4MMrT18BhVx4tx
Co-authored-by: Claude <noreply@anthropic.com>
---
 .../20597-react-prop-deprecated-message-words.md   | 14 ++++++++++++++
 packages/lint/src/validate-react-page-props.ts     |  2 +-
 scripts/doc-authoring-prose-id.baseline.json       |  1 -
 3 files changed, 15 insertions(+), 2 deletions(-)
 create mode 100644 .changeset/20597-react-prop-deprecated-message-words.md

diff --git a/.changeset/20597-react-prop-deprecated-message-words.md b/.changeset/20597-react-prop-deprecated-message-words.md
new file mode 100644
index 00000000000..7e6fb797ca9
--- /dev/null
+++ b/.changeset/20597-react-prop-deprecated-message-words.md
@@ -0,0 +1,14 @@
+---
+'@objectstack/lint': patch
+---
+
+The `react-prop-deprecated` warning states its reason in words instead of citing a tracker number
+
+The finding `validateReactPageProps` reports for a react-page prop written in a
+deprecated react-tier spelling used to end by pointing the author at an issue
+number that no longer resolves. It now says what that decision was, in the
+sentence being read: the react tier converges on the metadata-tier vocabulary,
+so the deprecated spelling keeps working through the deprecation window and is
+removed after it. The block tag, the prop and the canonical metadata-tier
+spelling it names are unchanged, and so are the rule id, the `warning`
+severity, the hint and every other finding.
diff --git a/packages/lint/src/validate-react-page-props.ts b/packages/lint/src/validate-react-page-props.ts
index f5684f07744..55de4782567 100644
--- a/packages/lint/src/validate-react-page-props.ts
+++ b/packages/lint/src/validate-react-page-props.ts
@@ -1195,7 +1195,7 @@ export function validateReactPageProps(stack: AnyRec): ReactPropFinding[] {
                 severity: 'warning',
                 rule: REACT_PROP_DEPRECATED,
                 where, path,
-                message: `<${tag}> prop "${u}" is the deprecated spelling of the metadata-tier "${dep.replacedBy}" and is removed after the deprecation window (#11284).`,
+                message: `<${tag}> prop "${u}" is the deprecated spelling of the metadata-tier "${dep.replacedBy}": the react tier converges on the metadata-tier vocabulary, so this spelling keeps working through the deprecation window and is removed after it.`,
                 hint: dep.note,
               });
             }
diff --git a/scripts/doc-authoring-prose-id.baseline.json b/scripts/doc-authoring-prose-id.baseline.json
index fad4260e0bd..af8a33d216b 100644
--- a/scripts/doc-authoring-prose-id.baseline.json
+++ b/scripts/doc-authoring-prose-id.baseline.json
@@ -287,7 +287,6 @@
   "#7696": 1
  },
  "packages/lint/src/validate-react-page-props.ts": {
-  "#11284": 1,
   "#5583": 1
  },
  "packages/lint/src/validate-readonly-flow-writes.ts": {