Skip to content

Commit cd29aef

Browse files
committed
docs(data-modeling,skills): re-quote the corrected searchable-fields hint, drop the moot caveat
Fixes #6925 PR #6921 (#6673) changed the `searchable-field-unknown` lint hint in `packages/lint/src/validate-searchable-fields.ts` from "copy the value onto a formula field here" to "copy the value onto a stored text field here" — a formula field is virtual and materializes no column, so the old prescription never worked. Two docs blocks quote that hint verbatim (added by PR #6670, before #6673 landed) and each carried an inline caveat noting the quoted wording was loose. Both are now stale: the quote reproduces text the tool no longer emits, and the caveat describes wording that no longer exists. - content/docs/data-modeling/schema-design.mdx: re-quote + drop caveat - skills/objectstack-data/SKILL.md: re-quote + drop caveat Verified the corrected quote is byte-for-byte identical to the tool's actual hint string on origin/main. No other content/docs/** or skills/** location quotes the stale "formula field" wording (grepped repo-wide). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01F8q5J1MQyocgtNspb15fSn
1 parent 3028326 commit cd29aef

2 files changed

Lines changed: 2 additions & 7 deletions

File tree

content/docs/data-modeling/schema-design.mdx

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -169,14 +169,11 @@ every entry is dropped.
169169
170170
hint: 'search' scans this object's own columns, so a related record's column
171171
cannot be a search target — expand the relation and search the related object,
172-
or copy the value onto a formula field here. Clients echo this declaration
172+
or copy the value onto a stored text field here. Clients echo this declaration
173173
verbatim as the '$searchFields' override, so a stale entry becomes a 400
174174
INVALID_FIELD on list search (#4254), not just a quietly narrowed one.
175175
```
176176

177-
(That hint's "text/formula" family of wording is loose — only the **stored**
178-
half works; see the callout above.)
179-
180177
A request that sends the dotted path is `400 INVALID_FIELD`:
181178

182179
```text

skills/objectstack-data/SKILL.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -168,13 +168,11 @@ every entry is dropped.
168168
169169
hint: 'search' scans this object's own columns, so a related record's column
170170
cannot be a search target — expand the relation and search the related object,
171-
or copy the value onto a formula field here. Clients echo this declaration
171+
or copy the value onto a stored text field here. Clients echo this declaration
172172
verbatim as the '$searchFields' override, so a stale entry becomes a 400
173173
INVALID_FIELD on list search (#4254), not just a quietly narrowed one.
174174
```
175175

176-
(The hint's "formula field" wording is loose — only a **stored** mirror works.)
177-
178176
A request carrying the dotted path is `400 INVALID_FIELD`:
179177

180178
```text

0 commit comments

Comments
 (0)