Skip to content

Conversation

@aidankmcalister
Copy link
Member

@aidankmcalister aidankmcalister commented Jan 13, 2026

Summary by CodeRabbit

  • Documentation
    • Updated redirect links across error reference documentation pages to correct navigation paths. Changes affect five documentation pages covering Prisma migration errors (foreign keys, provider switching, conflict resolution, shadow database) and MongoDB replica set configuration, improving user navigation to relevant resources.

✏️ Tip: You can customize this high-level summary in your review settings.

@github-actions
Copy link
Contributor

Dangerous URL check

No absolute URLs to prisma.io/docs found.
No local URLs found.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 13, 2026

Walkthrough

This PR updates redirect paths in five error documentation files from /orm/... to /docs/orm/... format, systematically adding the /docs prefix to internal documentation links across the error reference section.

Changes

Cohort / File(s) Change Summary
Redirect Path Updates — Error Documentation
content/200-orm/500-reference/300-errors/migrate-no-foreign-keys.mdx, migrate-provider-switch.mdx, migrate-resolve.mdx, migrate-shadow.mdx, mongodb-replica-set.mdx
Updated redirect target paths from /orm/... to /docs/orm/... in five files. Each file receives a single line modification updating the destination URL for the Redirect component. No logic, control flow, or structural changes—purely routing path updates.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

This is a homogeneous, repetitive change applied uniformly across all files with no logic density, structural complexity, or conditional reasoning required per file. All five files follow an identical modification pattern, making this a straightforward verification task.

Possibly related PRs

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 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.
Title check ✅ Passed The title accurately and concisely describes the main change: adding '/docs' prefixes to multiple redirect targets to fix 404 errors in search results.

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


Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link
Contributor

Redirect check

This PR probably requires the following redirects to be added to static/_redirects:

  • This PR does not change any pages in a way that would require a redirect.

@cloudflare-workers-and-pages
Copy link

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: cfb6ad3
Status: ✅  Deploy successful!
Preview URL: https://361e716e.docs-51g.pages.dev
Branch Preview URL: https://6749-404s-returned-in-search.docs-51g.pages.dev

View logs

@aidankmcalister aidankmcalister changed the title added /docs to multiple search results to counter 404 errors DR-6749 added /docs to multiple search results to counter 404 errors Jan 13, 2026
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

🤖 Fix all issues with AI agents
In @content/200-orm/500-reference/300-errors/migrate-no-foreign-keys.mdx:
- Line 8: The Redirect in migrate-no-foreign-keys.mdx uses an incorrect target
with a "/docs" prefix; update the Redirect component's to value to
"/orm/overview/databases/planetscale#option-1-emulate-relations-in-prisma-client"
(remove the "/docs" prefix) and apply the same fix to the other affected files
that use Redirect (mongodb-replica-set.mdx, migrate-shadow.mdx,
migrate-resolve.mdx, migrate-provider-switch.mdx) so all targets follow the
established "/orm/..." routing pattern.
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 776bb74 and cfb6ad3.

📒 Files selected for processing (5)
  • content/200-orm/500-reference/300-errors/migrate-no-foreign-keys.mdx
  • content/200-orm/500-reference/300-errors/migrate-provider-switch.mdx
  • content/200-orm/500-reference/300-errors/migrate-resolve.mdx
  • content/200-orm/500-reference/300-errors/migrate-shadow.mdx
  • content/200-orm/500-reference/300-errors/mongodb-replica-set.mdx
🧰 Additional context used
🧠 Learnings (1)
📚 Learning: 2026-01-06T22:06:57.725Z
Learnt from: newclarityex
Repo: prisma/docs PR: 7425
File: content/200-orm/050-overview/500-databases/400-mysql.mdx:80-80
Timestamp: 2026-01-06T22:06:57.725Z
Learning: In Prisma docs, when showing examples of instantiating driver adapters with connection strings from environment variables, use the template literal pattern `const connectionString = `${process.env.DATABASE_URL}`` for consistency across all database adapter examples (PostgreSQL, MySQL/MariaDB, etc.).

Applied to files:

  • content/200-orm/500-reference/300-errors/migrate-no-foreign-keys.mdx
  • content/200-orm/500-reference/300-errors/mongodb-replica-set.mdx
  • content/200-orm/500-reference/300-errors/migrate-shadow.mdx
  • content/200-orm/500-reference/300-errors/migrate-resolve.mdx
  • content/200-orm/500-reference/300-errors/migrate-provider-switch.mdx
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Check internal links
🔇 Additional comments (4)
content/200-orm/500-reference/300-errors/mongodb-replica-set.mdx (1)

8-8: LGTM! Redirect path correctly prefixed.

The /docs prefix addition follows the same pattern as the other files in this PR. The anchor #how-to-use-mongodb-replica-sets should correctly deep-link users to the relevant section.

content/200-orm/500-reference/300-errors/migrate-shadow.mdx (1)

8-8: LGTM! Redirect updated consistently.

This follows the same /docs prefix pattern applied across the PR. Users searching for shadow database error information will now be correctly routed to the documentation.

content/200-orm/500-reference/300-errors/migrate-provider-switch.mdx (1)

8-8: LGTM! Redirect path updated correctly.

The /docs prefix is properly added. The specific anchor #you-cannot-automatically-switch-database-providers ensures users land exactly where they need to be when encountering this error.

content/200-orm/500-reference/300-errors/migrate-resolve.mdx (1)

8-8: Redirect target is valid and anchor exists.

The redirect in migrate-resolve.mdx correctly points to /docs/orm/prisma-migrate/workflows/patching-and-hotfixing#failed-migration, where the "Failed migration" heading exists at line 71 of the target file.

However, I need to flag an issue with the broader claims in this review: there are actually 13 redirect files in the codebase, not 5. More importantly, redirect usage is inconsistent—some use the /docs prefix (like migrate-resolve, mongodb-replica-set, migrate-shadow, migrate-no-foreign-keys) while others don't (like connection-pool, migrate-no-direct-ddl, migrate-baseline, migrate). The claim that "all five redirect files in this PR now consistently use the /docs prefix" doesn't hold up to scrutiny.

If this PR only touches a subset of files, that's fine—but the characterization of consistency should be more precise about scope.

@aidankmcalister aidankmcalister merged commit 890150e into main Jan 13, 2026
8 checks passed
@aidankmcalister aidankmcalister deleted the 6749-404s-returned-in-search branch January 13, 2026 15:03
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.

3 participants