Skip to content

[v2] Alpha docs improvements - #2283

Merged
crutchcorn merged 2 commits into
alphafrom
alpha-docs-improvements
Aug 8, 2026
Merged

[v2] Alpha docs improvements#2283
crutchcorn merged 2 commits into
alphafrom
alpha-docs-improvements

Conversation

@crutchcorn

Copy link
Copy Markdown
Member

Merges the following into alpha from main:

#2266
#2278

crutchcorn and others added 2 commits August 8, 2026 14:59
* docs(config): remove nav entries pointing at non-existent reference pages

Six sidebar entries in docs/config.json referenced reference pages that do
not exist, so each rendered as a 404.

FieldMeta, FieldState and FieldInfo lost their generated pages in 6a73479
without config.json being updated to match. useTransform is not exported
from @tanstack/react-form, and vue/solid never had UseField/CreateField
types. Repoint the FieldMeta entry to AnyFieldMeta, the surviving public
field-metadata type, and drop the rest.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017z89Nb8dzFPu7VnsvN2VA9

* chore(scripts): verify docs/config.json nav targets in verify-links

verify-links only extracted links written inside .md files, so sidebar
entries in docs/config.json were never checked and could point at pages
that no longer exist without failing CI.

Walk every `to` in the nav config and resolve it the same way markdown
links are resolved, including the framework examples directory mapping.
Failures report the nav breadcrumb so the offending entry is easy to
locate. The shared resolution logic is extracted into resolveDocTarget so
the two checks cannot drift apart.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017z89Nb8dzFPu7VnsvN2VA9

* fix(scripts): fail verify-links when the check itself throws

The rejection handler only logged, so Node still exited 0. Reading or
parsing docs/config.json can now throw, which meant test:docs could pass
while the navigation check never ran.

Confirmed by pointing the script at malformed and missing config files:
both exited 0 before this change and exit 1 after.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017z89Nb8dzFPu7VnsvN2VA9

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
# Conflicts:
#	docs/config.json
@crutchcorn
crutchcorn requested a review from a team as a code owner August 8, 2026 22:03
@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 70d4b872-d343-402c-aa5e-28d710a5d58a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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.

@nx-cloud

nx-cloud Bot commented Aug 8, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit 8df110e

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

☁️ Nx Cloud last updated this comment at 2026-08-08 22:05:37 UTC

@github-actions

github-actions Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@pkg-pr-new

pkg-pr-new Bot commented Aug 8, 2026

Copy link
Copy Markdown
More templates

@tanstack/angular-form

npm i https://pkg.pr.new/@tanstack/angular-form@2283

@tanstack/form-core

npm i https://pkg.pr.new/@tanstack/form-core@2283

@tanstack/form-devtools

npm i https://pkg.pr.new/@tanstack/form-devtools@2283

@tanstack/lit-form

npm i https://pkg.pr.new/@tanstack/lit-form@2283

@tanstack/preact-form

npm i https://pkg.pr.new/@tanstack/preact-form@2283

@tanstack/react-form

npm i https://pkg.pr.new/@tanstack/react-form@2283

@tanstack/react-form-devtools

npm i https://pkg.pr.new/@tanstack/react-form-devtools@2283

@tanstack/react-form-nextjs

npm i https://pkg.pr.new/@tanstack/react-form-nextjs@2283

@tanstack/react-form-start

npm i https://pkg.pr.new/@tanstack/react-form-start@2283

@tanstack/solid-form

npm i https://pkg.pr.new/@tanstack/solid-form@2283

@tanstack/solid-form-devtools

npm i https://pkg.pr.new/@tanstack/solid-form-devtools@2283

@tanstack/svelte-form

npm i https://pkg.pr.new/@tanstack/svelte-form@2283

@tanstack/vue-form

npm i https://pkg.pr.new/@tanstack/vue-form@2283

commit: 8df110e

@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (alpha@e72cb0b). Learn more about missing BASE report.
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@           Coverage Diff            @@
##             alpha    #2283   +/-   ##
========================================
  Coverage         ?   91.82%           
========================================
  Files            ?       20           
  Lines            ?      269           
  Branches         ?       40           
========================================
  Hits             ?      247           
  Misses           ?       21           
  Partials         ?        1           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@crutchcorn
crutchcorn merged commit 626012c into alpha Aug 8, 2026
9 checks passed
@crutchcorn
crutchcorn deleted the alpha-docs-improvements branch August 8, 2026 22:38
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.

4 participants