Skip to content

Commit fa6b436

Browse files
docs(kernel): re-quote QueryOptionsV2's JSDoc after #7003's convergence edit (#7063)
Fixes #7002 PR #7003 (#6795) reworded QueryOptionsV2's JSDoc in packages/client/src/index.ts: it no longer calls itself "the recommended interface for `data.find()` queries" — that self-description was a contradiction with `find()`'s own `@deprecated` tag. The new sentence reads "This is the vocabulary `data.find()` still accepts" and is explicitly not a recommendation. content/docs/kernel/runtime-services/data-service.mdx quoted the old sentence verbatim, attributed to that source, in two spots. Both are re-quoted from the current main JSDoc text, and in both spots the surrounding prose that editorialized on the old "recommended" framing is corrected alongside the quote — a corrected quote under an unfixed claim would still be a half-fix. No other content/docs/** or skills/** location quotes the stale sentence (grepped repo-wide). .changeset/query-options-v2-not-a-recommendation.md also contains the phrase, but only as a past-tense description of what #7003 fixed — that's a legitimate changelog record, not a stale live quote, and is left untouched. Claude-Session: https://claude.ai/code/session_01F8q5J1MQyocgtNspb15fSn Co-authored-by: Claude <noreply@anthropic.com>
1 parent 6155c3c commit fa6b436

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

content/docs/kernel/runtime-services/data-service.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ deprecate the legacy-parameter query entries, promote `data.query(AST)`).
5757
Deprecated means "prefer `query`", not "scheduled for removal in this version":
5858
`find` remains fully functional, keeps both of its option vocabularies (see
5959
[below](#find-options-canonical-and-legacy)), and the Canonical source still
60-
names `QueryOptionsV2` *"the recommended interface for `data.find()` queries"*
60+
describes `QueryOptionsV2` as *"the vocabulary `data.find()` still accepts"*
6161
for callers that stay on it. The capability line between the two entries is
6262
real, though. `find` rides GET query parameters, so it has no spelling for a
6363
`search` term or for nested `expand` detail — it refuses a nested expand with an
@@ -98,7 +98,7 @@ key for key. A managed runtime binds `services.data` to this same shape.
9898
9999
The signature above accepts `QueryOptions | QueryOptionsV2`, and the Canonical source
100100
declares which of the two to write. `QueryOptionsV2` is *"canonical query options using
101-
Spec protocol field names … the recommended interface for `data.find()` queries"*, while
101+
Spec protocol field names … the vocabulary `data.find()` still accepts"*, while
102102
`QueryOptions` carries an `@deprecated` tag in the same file describing *"legacy parameter
103103
names … that require translation to QueryAST"*, with the instruction to *"prefer QueryAST
104104
fields directly"*. Both interfaces are declared in `packages/client/src/index.ts`, so the

0 commit comments

Comments
 (0)