Skip to content

fix(docs): update 404 reports #7675

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mhartington wants to merge 2 commits into
base: main
Choose a base branch
from
Open

fix(docs): update 404 reports #7675

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5b0535d
fix(docs): update 404 reports
mhartington Mar 19, 2026
477a866
fix(docs): add missing permanent key
mhartington Mar 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion apps/docs/vercel.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1259,6 +1259,25 @@
{"source": "/docs/getting-started/setup-prisma/start-from-scratch/typescript-postgresql", "destination": "/docs/prisma-orm/quickstart/postgresql", "permanent": true},
{"source": "/docs/guides/multi-tenancy", "destination": "/docs/guides/database/multiple-databases", "permanent": true},
{"source": "/docs/getting-started/setup-prisma/add-to-existing-project/relational-databases-typescript", "destination": "/docs/prisma-orm/add-to-existing-project/postgresql", "permanent": true},
{"source": "/docs/orm/prisma---client/setup-and-configuration/instantiate-prisma-client", "destination": "/docs/orm/prisma-client/setup-and-configuration/introduction", "permanent": true},
{"source": "/docs/guides/database/troubleshooting-orm/help-articles/nextjs-prisma-client-dev-practices", "destination": "/docs/orm/more/troubleshooting/nextjs", "permanent": true},
{"source": "/docs/console/features/optimize", "destination": "/docs/query-insights", "permanent": true},
{"source": "/docs/orm/more/helpers/prisma-with-nextjs-middleware", "destination": "/docs/orm/prisma-client/client-extensions", "permanent": true},
{"source": "/docs/orm/prisma-migrate.", "destination": "/docs/orm/prisma-migrate", "permanent": true},
{"source": "/docs/support/help-articles/autocompletion-in-graphql-resolvers-with-js", "destination": "/docs/orm/more/troubleshooting/graphql-autocompletion", "permanent": true},
{"source": "/docs/orm/reference/database-reference/sqlite", "destination": "/docs/orm/core-concepts/supported-databases/sqlite", "permanent": true},
{"source": "/docs/prisma-orm/quickstart/prisma-postgres/start-from-scratch", "destination": "/docs/prisma-orm/quickstart/prisma-postgres", "permanent": true},
{"source": "/docs/orm/prisma-schema/overviewhjgjug", "destination": "/docs/orm/prisma-schema/overview", "permanent": true},
{"source": "/docs/orm/more/upgrades/upgrade-to-prisma-orm-v6", "destination": "/docs/guides/upgrade-prisma-orm/v6", "permanent": true},
{"source": "/docs/orm/prisma-schema/data-model/constraints/unique-constraints", "destination": "/docs/orm/prisma-schema/data-model/indexes", "permanent": true},
{"source": "/docs/orm/prisma-migrate/workflows/prisma-migrate-dev", "destination": "/docs/orm/prisma-migrate/workflows/development-and-production", "permanent": true},
{"source": "/docs/getting-started/setup-prisma/start-from-scratch/relational-databases", "destination": "/docs/prisma-orm/quickstart/postgresql", "permanent": true},
{"source": "/docs/prisma-orm/add-to-existing-project-sqlite", "destination": "/docs/prisma-orm/add-to-existing-project/sqlite", "permanent": true},
{"source": "/docs/setup-prisma/start-from-scratch/relational-databse/querying-the-database-typescript-postgresql", "destination": "/docs/prisma-orm/quickstart/postgresql", "permanent": true},
{"source": "/docs/orm/prisma-client/setup-and-configuration/databases-connections/read-replicas", "destination": "/docs/orm/prisma-client/setup-and-configuration/read-replicas", "permanent": true},
{"source": "/docs/orm/more/help-and-troubleshooting/next-steps", "destination": "/docs/orm/more/troubleshooting/nextjs", "permanent": true},
Copy link
Contributor

@coderabbitai coderabbitai bot Mar 19, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

This next-steps redirect looks mis-targeted.

Line 948 already maps the next-steps help-article slug to Prisma Migrate troubleshooting, while the Next.js aliases in this file use nextjs-* source slugs. Sending this one to /docs/orm/more/troubleshooting/nextjs is likely routing users to the wrong page.

🔧 Suggested fix 
-    {"source": "/docs/orm/more/help-and-troubleshooting/next-steps", "destination": "/docs/orm/more/troubleshooting/nextjs", "permanent": true},
+    {"source": "/docs/orm/more/help-and-troubleshooting/next-steps", "destination": "/docs/orm/prisma-migrate/workflows/troubleshooting", "permanent": true},
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
{"source": "/docs/orm/more/help-and-troubleshooting/next-steps", "destination": "/docs/orm/more/troubleshooting/nextjs", "permanent": true},
{"source": "/docs/orm/more/help-and-troubleshooting/next-steps", "destination": "/docs/orm/prisma-migrate/workflows/troubleshooting", "permanent": true},
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@apps/docs/vercel.json` at line 1278, The redirect entry with source
"/docs/orm/more/help-and-troubleshooting/next-steps" currently points at
"/docs/orm/more/troubleshooting/nextjs" which conflicts with an existing
"next-steps" mapping and misroutes users; update this redirect so it either (A)
uses a Next.js-specific source slug to match the repo's "nextjs-*" pattern (e.g.
change the source to a "nextjs-..." slug) or (B) keeps the current source but
changes the destination to the Prisma Migrate troubleshooting target used by the
other "next-steps" mapping; modify the JSON entry containing the source
"/docs/orm/more/help-and-troubleshooting/next-steps" and destination
"/docs/orm/more/troubleshooting/nextjs" accordingly and remove the
duplicate/conflicting mapping.

{"source": "/docs/orm/reference/database-reference/postgresql", "destination": "/docs/orm/core-concepts/supported-databases/postgresql", "permanent": true},
{"source": "/docs/orm/prisma-client/deployment/edge", "destination": "/docs/orm/prisma-client/deployment/edge/overview", "permanent": true},
{"source": "/docs/guide/:path*", "destination": "/docs/guides/:path*", "permanent": true},
{"source": "/docs/-:junk", "destination": "/docs", "permanent": true},
{"source": "/docs/tutorials/-:junk", "destination": "/docs/tutorials", "permanent": true},
Expand All @@ -1275,7 +1294,7 @@
{"source": "/docs/about/:slug", "destination": "/docs", "permanent": true},
{"source": "/docs/concepts/overview/prisma-in-your-stack/:slug", "destination": "/docs/orm", "permanent": true},
{"source": "/docs/orm/more/help-and-troubleshooting/dataguide/:slug", "destination": "/docs/orm/more/troubleshooting/nextjs", "permanent": true},
{"source": "/docs/postgres/database/caching", "destination": "/docs/accelerate/caching"}
{"source": "/docs/postgres/database/caching", "destination": "/docs/accelerate/caching", "permanent": true}

]
}
Loading