Skip to content

docs: redirect /guides/upgrade-prisma-orm/v8 to the Prisma 8 upgrade hub - #8889

Open
ankur-arch wants to merge 1 commit into
mainfrom
docs/upgrade-guide-v8-redirect
Open

ankur-arch wants to merge 1 commit into
mainfrom
docs/upgrade-guide-v8-redirect

Conversation

@ankur-arch

@ankur-arch ankur-arch commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

/docs/guides/upgrade-prisma-orm/v8 now redirects to the Prisma 8 upgrade hub at /docs/guides/upgrade-prisma-orm. Today it returns a 404.

Why

The Prisma ORM 7 CLI prints an update notice that recommends Prisma 8 and links to https://pris.ly/d/major-version-upgrade, which lands on the Prisma 6 to 7 guide (prisma/orm#31110). The CLI fix builds the link from the major version being upgraded to, using the URL pattern the docs already follow for v3 through v7. Prisma 8 is the one major without a page at that pattern, because its guide is the section index.

What changes

One redirect in apps/docs/vercel.json. It is temporary (307), not permanent, so a dedicated v8 page can replace it later without fighting cached redirects.

Validation

node scripts/audit-redirects.mjs reports the same findings as main, with the redirect count going from 1517 to 1518.

Merge order: this should be live before the CLI change ships in a 7.x release.

Summary by CodeRabbit

  • Bug Fixes
    • Added a temporary redirect from the Prisma ORM v8 upgrade guide URL to the general upgrade guide.

Every major from v3 to v7 has an upgrade guide at /docs/guides/upgrade-prisma-orm/v{major}.
The Prisma 8 guide lives on the section index, so /v8 returned a 404. The Prisma ORM 7 CLI
update notice is moving to the per-major URL (prisma/orm#31110), so /v8 needs to resolve.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
blog Ready Ready Preview Nov 20, 2026 12:10pm UTC
docs Ready Ready Preview Nov 20, 2026 12:10pm UTC
eclipse Ready Ready Preview Nov 20, 2026 12:10pm UTC
site Ready Ready Preview Nov 20, 2026 12:10pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
handbook Skipped Skipped Nov 20, 2026 12:10pm UTC

Request Review

@vercel
vercel Bot temporarily deployed to Preview – handbook November 20, 2026 12:08 Inactive
@prisma-gizmo

prisma-gizmo Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

✅ Gizmo reviewed 55b383e — posted 0 inline comment(s) this pass.

Open findings: none

Change walkthrough

This PR adds a single redirect to apps/docs/vercel.json:918: /docs/guides/upgrade-prisma-orm/v8 → /docs/guides/upgrade-prisma-orm, closing a 404 that the Prisma 7 CLI's update notice can send users to via pris.ly/d/major-version-upgrade.

How it fits the codebase. The docs app keeps its platform-level redirect table in apps/docs/vercel.json, and the v3–v7 upgrade-guide redirects all live there as exact-source entries — this entry slots directly after the upgrading-to-prisma-7 block, extending the established pattern to v8. The destination resolves to real content: content/docs/guides/upgrade-prisma-orm/index.mdx carries url: /guides/upgrade-prisma-orm. permanent: false yields a 307, deliberately avoiding cached-redirect pain if a dedicated v8 guide page later replaces the redirect.

@coderabbitai

coderabbitai Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

The Vercel configuration adds a temporary redirect from the Prisma ORM v8 upgrade guide path to the general Prisma ORM upgrade guide.

Changes

Documentation redirect

Layer / File(s) Summary
Add upgrade guide redirect
apps/docs/vercel.json
A temporary redirect maps /docs/guides/upgrade-prisma-orm/v8 to /docs/guides/upgrade-prisma-orm.

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

Suggested reviewers: amanvarshney01

Merge Risk: Minimal · up to 55b38

This adds a temporary redirect so the Prisma ORM v8 upgrade guide URL resolves to the general upgrade guide instead of returning a 404. No material merge risk was found.

Pre-merge checks: Passed 4

Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title names the main change: a docs redirect from the /v8 upgrade guide URL to the Prisma 8 upgrade hub. The changeset adds one temporary redirect in apps/docs/vercel.json from /docs/guides/upgrad…
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.
Full details: Title check

Explanation

The title names the main change: a docs redirect from the /v8 upgrade guide URL to the Prisma 8 upgrade hub. The changeset adds one temporary redirect in apps/docs/vercel.json from /docs/guides/upgrade-prisma-orm/v8 to /docs/guides/upgrade-prisma-orm, which matches the title. The title is 72 characters, within a typical length limit, and uses the conventional docs: prefix. The title is slightly loose in calling the target the Prisma 8 upgrade hub, but the target path is the section index for the upgrade guides, so the wording stays accurate.

Finishing Touches

Generate unit tests (beta)

  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts
Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Repository UI
  • Review profile: CHILL
  • Plan: Essentials
  • Run ID: 7b32117f-1af4-45c1-829c-60e8e83e4f93
Commits

Reviewing files that changed from the base of the PR and between 9179bfd and 55b383e.

Files selected for processing: 1

  • apps/docs/vercel.json

Included review availability: This review used your included allowance. 4 included reviews remain after this review. Your included PR review attempts over the past 7 days set your current allowance at 5 reviews per hour.

@prisma-gizmo prisma-gizmo Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

New findings: none · trace

@prisma-gizmo prisma-gizmo Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No Gizmo finding is open and the head commit has been reviewed. Approving.

This branch was successfully deployed

5 active and 1 inactive deployments
Preview – docs — 55b383e9 Deployed Nov 20, 2026 by vercel[bot]
Preview – blog — 55b383e9 Deployed Nov 20, 2026 by vercel[bot]
Preview – site — 55b383e9 Deployed Nov 20, 2026 by vercel[bot]
Preview – eclipse — 55b383e9 Deployed Nov 20, 2026 by vercel[bot]
Preview – handbook — 55b383e9 Deployed Nov 20, 2026 by vercel[bot]
prisma-preview/docs/upgrade-guide-v8-redirect — 55b383e9 Deployed Nov 20, 2026 by ankur-arch via deploy #1366
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