Skip to content

Conversation

@aidankmcalister
Copy link
Member

@aidankmcalister aidankmcalister commented Nov 19, 2025

Summary by CodeRabbit

  • Documentation
    • Updated several Getting Started guides to redirect to new /docs/* destinations instead of their previous locations.
    • Added site-level redirect entries mapping legacy ORM/Postgres Getting Started URLs to the new /docs/ paths.
    • Affected guides: Prisma ORM (quickstart, add-to-existing-project) and PostgreSQL (quickstart, import-from-existing-database).

@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 Nov 19, 2025

Walkthrough

Updated four MDX Redirect target paths to new /docs/... locations and appended four corresponding mappings to static/_redirects. No changes to exported/public APIs or other content.

Changes

Cohort / File(s) Summary
MDX: updated Redirect targets
content/200-orm/025-getting-started/10-quickstart.mdx, content/200-orm/025-getting-started/20-add-to-existing-project.mdx, content/250-postgres/50-getting-started/100-quickstart.mdx, content/250-postgres/50-getting-started/200-import-from-existing-database.mdx
Updated the Redirect component target paths to new /docs/... destinations. No other content, imports, or exported entities modified.
Site redirects file: added mappings
static/_redirects
Appended four new redirect lines mapping legacy /orm/... and /postgres/... source paths to their /docs/... destinations. No existing mappings removed.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Homogeneous, low-risk changes (path updates + added redirect lines).
  • Pay extra attention to:
    • Remaining unused Redirect imports in MDX files (remove if present).
    • Correct syntax/placement of the new lines in static/_redirects to avoid formatting issues or duplicates.

Possibly related PRs

Pre-merge checks

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly addresses the main change: fixing broken redirects in quickstart documentation by updating redirect paths to include the /docs prefix.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📜 Recent 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 805c17e and 6c935bc.

📒 Files selected for processing (4)
  • content/200-orm/025-getting-started/10-quickstart.mdx (1 hunks)
  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx (1 hunks)
  • content/250-postgres/50-getting-started/100-quickstart.mdx (1 hunks)
  • content/250-postgres/50-getting-started/200-import-from-existing-database.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • content/250-postgres/50-getting-started/100-quickstart.mdx
  • content/250-postgres/50-getting-started/200-import-from-existing-database.mdx
🧰 Additional context used
🧠 Learnings (4)
📚 Learning: 2025-10-08T16:23:00.388Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • content/200-orm/025-getting-started/10-quickstart.mdx
📚 Learning: 2025-10-08T16:23:00.388Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • content/200-orm/025-getting-started/10-quickstart.mdx
📚 Learning: 2025-10-08T16:22:57.129Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • content/200-orm/025-getting-started/10-quickstart.mdx
📚 Learning: 2025-10-14T11:41:08.844Z
Learnt from: carlagn
Repo: prisma/docs PR: 7183
File: content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx:561-567
Timestamp: 2025-10-14T11:41:08.844Z
Learning: Ignore the file `content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx` in future reviews as per user request. Issues in this file were addressed in PR #7185.

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • content/200-orm/025-getting-started/10-quickstart.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). (3)
  • GitHub Check: Check internal links
  • GitHub Check: Check links
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (1)
content/200-orm/025-getting-started/10-quickstart.mdx (1)

11-11: Redirect target is valid and properly configured.

The verification confirms the redirect change is correct. The target path /docs/getting-started/prisma-orm/quickstart/prisma-postgres maps to an existing documentation file, and the redirect is properly registered in static/_redirects (lines 819 and 822). The underlying content file exists at content/100-getting-started/02-prisma-orm/100-quickstart/100-prisma-postgres.mdx, and the URL structure correctly strips numeric prefixes from the file path. No broken redirects are introduced.


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.

@github-actions
Copy link
Contributor

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status Count
🔍 Total 2235
✅ Successful 2193
⏳ Timeouts 0
🔀 Redirected 4
👻 Excluded 23
❓ Unknown 0
🚫 Errors 14
⛔ Unsupported 1

Errors per input

Errors in 200-orm/500-reference/250-error-reference.mdx

Errors in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/06-upgrading-prisma-binding-to-sdl-first.mdx

Errors in 200-orm/800-more/400-comparisons/04-prisma-and-drizzle.mdx

Errors in 250-postgres/1200-more/1000-faq.mdx

Errors in 800-guides/050-migrate-from-mongoose.mdx

Errors in 800-guides/370-bun.mdx

coderabbitai[bot]
coderabbitai bot previously approved these changes Nov 19, 2025
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Nov 19, 2025

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6c935bc
Status: ✅  Deploy successful!
Preview URL: https://ceb885f7.docs-51g.pages.dev
Branch Preview URL: https://dc-6306-quickstart-broken-re-bqw3.docs-51g.pages.dev

View logs

coderabbitai[bot]
coderabbitai bot previously approved these changes Nov 19, 2025
@github-actions
Copy link
Contributor

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status Count
🔍 Total 2235
✅ Successful 2196
⏳ Timeouts 0
🔀 Redirected 3
👻 Excluded 23
❓ Unknown 0
🚫 Errors 12
⛔ Unsupported 1

Errors per input

Errors in 200-orm/050-overview/300-prisma-in-your-stack/01-rest.mdx

Errors in 200-orm/050-overview/300-prisma-in-your-stack/02-graphql.mdx

Errors in 200-orm/200-prisma-client/600-observability-and-logging/250-opentelemetry-tracing.mdx

Errors in 200-orm/500-reference/250-error-reference.mdx

Errors in 800-guides/050-migrate-from-mongoose.mdx

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: 0

🧹 Nitpick comments (1)
content/200-orm/025-getting-started/10-quickstart.mdx (1)

11-11: Clarify the intent of commenting out vs. removing the redirect.

The redirect is disabled by commenting rather than removing it entirely. While this aligns with disabling the broken redirect (per the PR objectives), it's worth clarifying whether this is:

  • A temporary measure pending further routing restructuring?
  • An intentional reference to keep the old path pattern visible?
  • A conservative approach to avoid accidentally breaking anything?

This will help future maintainers understand the design decision.

📜 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 da6213f and 11e0c1d.

📒 Files selected for processing (2)
  • content/200-orm/025-getting-started/10-quickstart.mdx (1 hunks)
  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
🧰 Additional context used
🧠 Learnings (3)
📚 Learning: 2025-10-08T16:22:57.129Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

  • content/200-orm/025-getting-started/10-quickstart.mdx
📚 Learning: 2025-10-08T16:23:00.388Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

  • content/200-orm/025-getting-started/10-quickstart.mdx
📚 Learning: 2025-10-14T11:41:08.844Z
Learnt from: carlagn
Repo: prisma/docs PR: 7183
File: content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx:561-567
Timestamp: 2025-10-14T11:41:08.844Z
Learning: Ignore the file `content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx` in future reviews as per user request. Issues in this file were addressed in PR #7185.

Applied to files:

  • content/200-orm/025-getting-started/10-quickstart.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). (2)
  • GitHub Check: Check internal links
  • GitHub Check: Cloudflare Pages

coderabbitai[bot]
coderabbitai bot previously approved these changes Nov 19, 2025
@github-actions
Copy link
Contributor

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status Count
🔍 Total 2235
✅ Successful 2198
⏳ Timeouts 0
🔀 Redirected 3
👻 Excluded 23
❓ Unknown 0
🚫 Errors 10
⛔ Unsupported 1

Errors per input

Errors in 200-orm/500-reference/250-error-reference.mdx

Errors in 800-guides/050-migrate-from-mongoose.mdx

Errors in 800-guides/370-bun.mdx

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

📜 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 11e0c1d and 805c17e.

📒 Files selected for processing (5)
  • content/200-orm/025-getting-started/10-quickstart.mdx (1 hunks)
  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx (1 hunks)
  • content/250-postgres/50-getting-started/100-quickstart.mdx (1 hunks)
  • content/250-postgres/50-getting-started/200-import-from-existing-database.mdx (1 hunks)
  • static/_redirects (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • content/250-postgres/50-getting-started/100-quickstart.mdx
  • content/200-orm/025-getting-started/10-quickstart.mdx
🧰 Additional context used
🧠 Learnings (5)
📓 Common learnings
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.
📚 Learning: 2025-10-08T16:22:57.129Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • content/250-postgres/50-getting-started/200-import-from-existing-database.mdx
📚 Learning: 2025-10-08T16:23:00.388Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
📚 Learning: 2025-10-14T11:41:08.844Z
Learnt from: carlagn
Repo: prisma/docs PR: 7183
File: content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx:561-567
Timestamp: 2025-10-14T11:41:08.844Z
Learning: Ignore the file `content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx` in future reviews as per user request. Issues in this file were addressed in PR #7185.

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • content/250-postgres/50-getting-started/200-import-from-existing-database.mdx
📚 Learning: 2025-10-08T16:23:00.388Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: All headings and titles should use sentence case (e.g., "Getting started with Prisma ORM", "Best practices for authentication"), not title case. Exception: Always preserve exact casing for product names including "Prisma Postgres", "Prisma", "Prisma ORM", and "Prisma Data Platform".

Applied to files:

  • content/200-orm/025-getting-started/20-add-to-existing-project.mdx
  • static/_redirects
⏰ 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). (2)
  • GitHub Check: Check internal links
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (2)
content/250-postgres/50-getting-started/200-import-from-existing-database.mdx (1)

1-7: LGTM - Clean migration to server-side redirects.

The removal of client-side redirect logic in favor of server-side redirects (in static/_redirects) is the correct approach. This improves performance and maintainability.

content/200-orm/025-getting-started/20-add-to-existing-project.mdx (1)

1-7: LGTM - Consistent with redirect migration pattern.

The change aligns with the migration strategy to use server-side redirects instead of client-side redirect components.

mhessdev
mhessdev previously approved these changes Nov 19, 2025
@aidankmcalister aidankmcalister merged commit ce8bb47 into main Nov 19, 2025
7 of 8 checks passed
@aidankmcalister aidankmcalister deleted the DC-6306-quickstart-broken-redirect-2 branch November 19, 2025 18:47
@github-actions
Copy link
Contributor

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status Count
🔍 Total 2235
✅ Successful 1986
⏳ Timeouts 0
🔀 Redirected 216
👻 Excluded 23
❓ Unknown 0
🚫 Errors 9
⛔ Unsupported 1

Errors per input

Errors in 200-orm/500-reference/250-error-reference.mdx

Errors in 800-guides/050-migrate-from-mongoose.mdx

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