Skip to content

fix(docs): update 404 reports#7675

Open
mhartington wants to merge 2 commits intomainfrom
dr-7725/404-updates
Open

fix(docs): update 404 reports#7675
mhartington wants to merge 2 commits intomainfrom
dr-7725/404-updates

Conversation

@mhartington
Copy link
Member

@mhartington mhartington commented Mar 19, 2026

Summary by CodeRabbit

  • Chores
    • Added 19 permanent redirects mapping legacy/mis-typed docs routes to consolidated current documentation destinations (ORM, Prisma Client, Next.js troubleshooting, migrations, upgrades, database quickstarts, references, and edge deployment overview).
    • Converted an existing docs redirect for PostgreSQL caching to be permanent for consistent navigation.

@vercel
Copy link

vercel bot commented Mar 19, 2026

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Mar 19, 2026 7:11pm
docs Ready Ready Preview, Comment Mar 19, 2026 7:11pm
eclipse Ready Ready Preview, Comment Mar 19, 2026 7:11pm

Request Review

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 19, 2026

Walkthrough

Added 19 redirect rules to apps/docs/vercel.json and changed the existing /docs/postgres/database/caching redirect to permanent: true. Changes map multiple legacy and mistyped docs routes to consolidated /docs/orm/..., /docs/prisma-orm/..., and related destinations. No code/entity exports were altered.

Changes

Cohort / File(s) Summary
Vercel Redirect Configuration
apps/docs/vercel.json
Added 19 new redirect rules mapping legacy, mistyped, and restructured documentation paths to /docs/orm/..., /docs/prisma-orm/..., and related targets (Prisma Client setup, Next.js troubleshooting, query-insights, client-extensions, Prisma Migrate/v6 upgrade, unique constraints→indexes, dev→development-and-production workflows, PostgreSQL quickstart, read-replicas, next-steps, PostgreSQL/sqlite references, edge deployment overview). Also changed the existing /docs/postgres/database/caching redirect to permanent: true. Several source paths contain apparent typos or malformed segments (e.g., prisma---client, prisma-migrate., overviewhjgjug, databse) and should be audited for intentionality. Lines changed: +20/-1.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'fix(docs): update 404 reports' is vague and doesn't clearly convey what the actual changes accomplish—the PR adds 19 redirect rules to consolidate legacy documentation routes, which is a substantive infrastructure change beyond just 'updating 404 reports.' Consider a more specific title like 'fix(docs): add redirects for legacy documentation routes' or 'fix(docs): consolidate docs URLs with permanent redirects' to better reflect the scope and purpose of the changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

📝 Coding Plan
  • Generate coding plan for human review comments

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 and usage tips.

@argos-ci
Copy link

argos-ci bot commented Mar 19, 2026

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
default (Inspect) ✅ No changes detected - Mar 19, 2026, 7:04 PM

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
apps/docs/vercel.json (1)

1297-1297: ⚠️ Potential issue | 🟡 Minor

Missing "permanent": true property.

This redirect entry is missing the permanent property that all other 1,296 entries in this file include. Without it, Vercel defaults to a temporary (302) redirect instead of a permanent (301) redirect.

This inconsistency affects:

  • SEO: Search engines treat 301s and 302s differently for link equity transfer
  • Caching: Browsers cache permanent redirects more aggressively
  • Intent: If this is meant to be permanent like all others, it should be explicit
🔧 Proposed fix
-    {"source": "/docs/postgres/database/caching", "destination": "/docs/accelerate/caching"}
+    {"source": "/docs/postgres/database/caching", "destination": "/docs/accelerate/caching", "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 1297, The redirect object with "source":
"/docs/postgres/database/caching" and "destination": "/docs/accelerate/caching"
is missing the "permanent": true property; update that redirect entry to include
"permanent": true so it matches the other 1,296 entries and produces a 301
permanent redirect rather than a temporary 302.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@apps/docs/vercel.json`:
- Line 1297: The redirect object with "source":
"/docs/postgres/database/caching" and "destination": "/docs/accelerate/caching"
is missing the "permanent": true property; update that redirect entry to include
"permanent": true so it matches the other 1,296 entries and produces a 301
permanent redirect rather than a temporary 302.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 75af3b83-f4a6-4c7b-9fb2-0644c90df6c0

📥 Commits

Reviewing files that changed from the base of the PR and between 6ce797f and 5b0535d.

📒 Files selected for processing (1)
  • apps/docs/vercel.json

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (2)
apps/docs/vercel.json (2)

1297-1297: Collapse the caching redirect chain.

Line 862 still sends /docs/postgres/caching to this path first, so users take two redirects before landing on /docs/accelerate/caching. Point that older alias at the final destination directly.

🔀 Suggested follow-up
-    {"source": "/docs/postgres/caching", "destination": "/docs/postgres/database/caching", "permanent": true},
+    {"source": "/docs/postgres/caching", "destination": "/docs/accelerate/caching", "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 1297, The redirect chain causes an extra hop:
update the rule currently sending "/docs/postgres/caching" (which now points to
"/docs/postgres/database/caching") so that it directly maps to the final
destination "/docs/accelerate/caching"; locate the redirect entry with source
"/docs/postgres/caching" and change its destination to
"/docs/accelerate/caching" (ensuring no intermediate
"/docs/postgres/database/caching" target remains in that rule).

1267-1267: Keep the autocompletion aliases on one canonical destination.

This exact legacy slug already redirects to /docs/orm/more/troubleshooting/nextjs at Lines 154 and 828. Pointing the support-path alias at /docs/orm/more/troubleshooting/graphql-autocompletion means the same old article now resolves to two different pages depending on which prefix users hit.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/docs/vercel.json` at line 1267, The redirect entry that maps the legacy
slug "/docs/support/help-articles/autocompletion-in-graphql-resolvers-with-js"
currently points to "/docs/orm/more/troubleshooting/graphql-autocompletion",
creating a second destination for the same legacy slug; update this redirect so
the source
"/docs/support/help-articles/autocompletion-in-graphql-resolvers-with-js"
instead points to the single canonical destination
"/docs/orm/more/troubleshooting/nextjs" (or remove the duplicate redirect),
ensuring only one canonical alias exists for that legacy slug.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@apps/docs/vercel.json`:
- 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.

---

Nitpick comments:
In `@apps/docs/vercel.json`:
- Line 1297: The redirect chain causes an extra hop: update the rule currently
sending "/docs/postgres/caching" (which now points to
"/docs/postgres/database/caching") so that it directly maps to the final
destination "/docs/accelerate/caching"; locate the redirect entry with source
"/docs/postgres/caching" and change its destination to
"/docs/accelerate/caching" (ensuring no intermediate
"/docs/postgres/database/caching" target remains in that rule).
- Line 1267: The redirect entry that maps the legacy slug
"/docs/support/help-articles/autocompletion-in-graphql-resolvers-with-js"
currently points to "/docs/orm/more/troubleshooting/graphql-autocompletion",
creating a second destination for the same legacy slug; update this redirect so
the source
"/docs/support/help-articles/autocompletion-in-graphql-resolvers-with-js"
instead points to the single canonical destination
"/docs/orm/more/troubleshooting/nextjs" (or remove the duplicate redirect),
ensuring only one canonical alias exists for that legacy slug.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b343f61b-0030-48a3-8f80-ecf98c6d8db7

📥 Commits

Reviewing files that changed from the base of the PR and between 5b0535d and 477a866.

📒 Files selected for processing (1)
  • apps/docs/vercel.json

{"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

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.

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