Skip to content

docs(preact-query): add 'The Query Options API' link, matching react's queryOptions JSDoc - #11388

Merged
sukvvon merged 1 commit into
mainfrom
docs/preact-query-add-tkdodo-query-options-link
Sep 4, 2026
Merged

docs(preact-query): add 'The Query Options API' link, matching react's queryOptions JSDoc#11388
sukvvon merged 1 commit into
mainfrom
docs/preact-query-add-tkdodo-query-options-link

Conversation

@sukvvon

@sukvvon sukvvon commented Sep 4, 2026

Copy link
Copy Markdown
Member

🎯 Changes

Adds the @see [The Query Options API](https://tkdodo.eu/blog/the-query-options-api) link to queryOptions's JSDoc, matching react-query's.

packages/preact-query/src/queryOptions.ts is otherwise a near-exact mirror of packages/react-query/src/queryOptions.ts (same hook-based API, same JSX examples — diffing the two files shows only import path and this link as the differences), so the linked article's React code examples apply directly here too. This complements #11387, which removed the same link from solid-query where the reactive-getter API and examples don't carry over.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested code changes locally with pnpm run test:pr, or these tests do not apply to this pull request.
  • I fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

  • Documentation
    • Added links to the Query Options API article in the queryOptions reference documentation.
    • Updated source-reference line numbers for all documented queryOptions call signatures.

@nx-cloud

nx-cloud Bot commented Sep 4, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit b85b0d1

Command Status Duration Result
nx run-many --target=build --exclude=examples/*... ✅ Succeeded 7s View ↗
nx affected --targets=test:sherif,test:knip,tes... ✅ Succeeded 3m 18s View ↗

☁️ Nx Cloud last updated this comment at 2026-09-04 02:51:54 UTC

@coderabbitai

coderabbitai Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 8c028520-e7a1-4374-bedb-c6401ad0102a

📥 Commits

Reviewing files that changed from the base of the PR and between 19c96a5 and b85b0d1.

📒 Files selected for processing (2)
  • docs/framework/preact/reference/functions/queryOptions.md
  • packages/preact-query/src/queryOptions.ts

Included review availability: Your plan provides up to 10 included reviews per hour; 8 remain after this review.


📝 Walkthrough

Walkthrough

The change updates queryOptions documentation in source JSDoc and the Preact reference. It adds Query Options API links and corrects source-reference line numbers for all three overloads. No functional or type-level code changes were made.

Changes

queryOptions documentation

Layer / File(s) Summary
Source API references
packages/preact-query/src/queryOptions.ts
All three queryOptions overloads now include a @see link to the Query Options API article.
Preact reference updates
docs/framework/preact/reference/functions/queryOptions.md
The reference updates source line links and adds Query Options API article links for all three overloads.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to b85b0

This updates queryOptions documentation links and source references without changing library behavior. No current merge-readiness risk remains.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly describes the documentation-only change: adding the Query Options API link to Preact Query's queryOptions JSDoc to match React Query.
Description check ✅ Passed The description includes the required Changes, Checklist, and Release Impact sections. It explains the motivation, confirms testing and contribution checks, and identifies the change as documentation-…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/preact-query-add-tkdodo-query-options-link

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@sukvvon sukvvon self-assigned this Sep 4, 2026
@pkg-pr-new

pkg-pr-new Bot commented Sep 4, 2026

Copy link
Copy Markdown
More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@11388

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@11388

@tanstack/lit-query

npm i https://pkg.pr.new/@tanstack/lit-query@11388

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@11388

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@11388

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@11388

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@11388

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@11388

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@11388

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@11388

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@11388

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@11388

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@11388

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@11388

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@11388

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@11388

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@11388

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@11388

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@11388

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@11388

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@11388

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@11388

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@11388

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@11388

commit: b85b0d1

@github-actions

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

Path Size
react full 11.87 KB (0%)
react minimal 8.84 KB (0%)

@github-actions

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

2 package(s) bumped directly, 23 bumped as dependents.

🟨 Minor bumps

Package Version Reason
@tanstack/svelte-query 6.1.48 → 6.2.0 Changeset
@tanstack/svelte-query-devtools 6.1.48 → 6.2.0 Dependent
@tanstack/svelte-query-persist-client 6.1.48 → 6.2.0 Dependent
@tanstack/vue-query-devtools 6.1.48 → 6.2.0 Dependent

🟩 Patch bumps

Package Version Reason
@tanstack/query-core 5.102.8 → 5.102.9 Changeset
@tanstack/angular-query-experimental 5.102.8 → 5.102.9 Dependent
@tanstack/angular-query-persist-client 5.102.8 → 5.102.9 Dependent
@tanstack/eslint-plugin-query 5.102.8 → 5.102.9 Dependent
@tanstack/lit-query 0.2.20 → 0.2.21 Dependent
@tanstack/preact-query 5.102.8 → 5.102.9 Dependent
@tanstack/preact-query-devtools 5.102.8 → 5.102.9 Dependent
@tanstack/preact-query-persist-client 5.102.8 → 5.102.9 Dependent
@tanstack/query-async-storage-persister 5.102.8 → 5.102.9 Dependent
@tanstack/query-broadcast-client-experimental 5.102.8 → 5.102.9 Dependent
@tanstack/query-devtools 5.102.8 → 5.102.9 Dependent
@tanstack/query-persist-client-core 5.102.8 → 5.102.9 Dependent
@tanstack/query-sync-storage-persister 5.102.8 → 5.102.9 Dependent
@tanstack/react-query 5.102.8 → 5.102.9 Dependent
@tanstack/react-query-devtools 5.102.8 → 5.102.9 Dependent
@tanstack/react-query-next-experimental 5.102.8 → 5.102.9 Dependent
@tanstack/react-query-persist-client 5.102.8 → 5.102.9 Dependent
@tanstack/solid-query 5.102.8 → 5.102.9 Dependent
@tanstack/solid-query-devtools 5.102.8 → 5.102.9 Dependent
@tanstack/solid-query-persist-client 5.102.8 → 5.102.9 Dependent
@tanstack/vue-query 5.102.8 → 5.102.9 Dependent

@sukvvon
sukvvon merged commit b81a639 into main Sep 4, 2026
9 checks passed
@sukvvon
sukvvon deleted the docs/preact-query-add-tkdodo-query-options-link branch September 4, 2026 03:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant