Skip to content

docs(guides): fix dead Grit migration link in v0.31.0 migration guide#1537

Open
sanjibani wants to merge 1 commit into
open-circle:mainfrom
sanjibani:docs/fix-broken-grit-migration-link
Open

docs(guides): fix dead Grit migration link in v0.31.0 migration guide#1537
sanjibani wants to merge 1 commit into
open-circle:mainfrom
sanjibani:docs/fix-broken-grit-migration-link

Conversation

@sanjibani

@sanjibani sanjibani commented Jul 10, 2026

Copy link
Copy Markdown

The v0.31.0 migration guide points readers at the Grit registry page for the Valibot migration pattern, but that URL 404s:

$ curl -sIL -A 'Mozilla/5.0' https://docs.grit.io/registry/github.com/open-circle/valibot/migrate_to_v0_31_0
HTTP/2 404

The Grit registry moved/restructured since the migration was added, and the per-pattern docs page is no longer reachable. The Grit CLI command itself (npx @getgrit/cli apply github.com/open-circle/valibot#migrate_to_v0_31_0) still works, and the new docs.grit.io root is a sensible landing page for the Grit tool itself.

Replaced the broken per-pattern link with the canonical docs root, keeping both Codemod and Grit mentioned side by side as the guide does today. Verified the new URL returns HTTP 200:

$ curl -sIL -A 'Mozilla/5.0' https://docs.grit.io/
HTTP/2 200

Summary by CodeRabbit

  • Documentation
    • Updated the v0.31.0 migration guide to link to the general Grit documentation for automatic upgrades.

Signed-off-by: sanjibani <18418553+sanjibani@users.noreply.github.com>
@dosubot dosubot Bot added size:XS This PR changes 0-9 lines, ignoring generated files. documentation Improvements or additions to documentation fix A smaller enhancement or bug fix labels Jul 10, 2026
@coderabbitai

coderabbitai Bot commented Jul 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0c2ddfef-3c33-4d49-993f-7bf2973afa25

📥 Commits

Reviewing files that changed from the base of the PR and between 32247b3 and 2230c03.

📒 Files selected for processing (1)
  • website/src/routes/guides/(migration)/migrate-to-v0.31.0/index.mdx

Walkthrough

Updated the v0.31.0 migration guide’s “Automatic upgrade” paragraph to link to the generic Grit documentation instead of the specific migration registry URL.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: fixing a broken Grit migration link in the v0.31.0 guide.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

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.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Re-trigger cubic

@yslpn yslpn self-assigned this Jul 20, 2026
## Automatic upgrade

We worked together with [Codemod](https://codemod.com/registry/valibot-migrate-to-v0-31-0) and [Grit](https://docs.grit.io/registry/github.com/open-circle/valibot/migrate_to_v0_31_0) to automatically upgrade your schemas to the new version with a single CLI command. Both codemods are similar. You can use one or the other. Simply run the command in the directory of your project.
We worked together with [Codemod](https://codemod.com/registry/valibot-migrate-to-v0-31-0) and [Grit](https://docs.grit.io/) to automatically upgrade your schemas to the new version with a single CLI command. Both codemods are similar. You can use one or the other. Simply run the command in the directory of your project.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank for notice. Please also update codemod link

https://app.codemod.com/registry/valibot/migrate-to-v0.31.0

and fix conflicts

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation fix A smaller enhancement or bug fix size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants