Skip to content

Conversation

@aidankmcalister
Copy link
Member

@aidankmcalister aidankmcalister commented Nov 5, 2025

Summary by CodeRabbit

  • Documentation
    • Removed comprehensive middleware guides, examples, and best-practices across Prisma docs
    • Deleted $use() middleware reference from the API docs
    • Removed middleware recommendations and examples from client-extensions, Optimize/Accelerate, AI-tools, observability, and preview-features pages
    • Updated examples and ordering guidance to favor client extensions over middleware; minor formatting tweaks in preview tables

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 5, 2025

Walkthrough

This PR removes or refactors middleware-related documentation across the docs: deletes multiple middleware example pages, eliminates middleware guidance and comparisons in client-extensions and API reference, updates extension ordering examples to exclude middleware, and adjusts an instrumentation example to instantiate PrismaInstrumentation without middleware options.

Changes

Cohort / File(s) Summary
Deleted middleware examples
content/200-orm/200-prisma-client/300-client-extensions/500-middleware/100-soft-delete-middleware.mdx, content/200-orm/200-prisma-client/300-client-extensions/500-middleware/200-logging-middleware.mdx, content/200-orm/200-prisma-client/300-client-extensions/500-middleware/300-session-data-middleware.mdx
Removed three full middleware example pages (soft-delete, logging durations, session-data injection).
Removed middleware index & subsection
content/200-orm/200-prisma-client/300-client-extensions/500-middleware/index.mdx, content/200-orm/200-prisma-client/300-client-extensions/index.mdx
Deleted the middleware index page and removed the "Usage of $on and $use with extended clients" subsection.
Queries & client-extensions edits
content/200-orm/200-prisma-client/100-queries/100-query-optimization-performance.mdx, content/200-orm/200-prisma-client/300-client-extensions/120-query.mdx
Removed logging-middleware recommendation from query optimization; revised query extension description and deleted the "Query extensions versus middlewares" section.
API reference removal
content/200-orm/500-reference/050-prisma-client-reference.mdx
Removed the $use() middleware API block and related guidance from the Prisma Client reference.
Preview features table update
content/200-orm/500-reference/500-preview-features/050-client-preview-features.mdx
Removed the "middlewares" row from the preview-features table and adjusted table formatting.
Extension ordering & examples
content/250-postgres/400-query-optimization/100-setup.mdx, content/300-accelerate/200-getting-started.mdx, content/700-optimize/200-getting-started.mdx
Removed middleware mentions from headings/examples, updated extension chaining/ordering examples to focus solely on extensions (including explicit order recommendations).
AI tools docs edits
content/200-orm/800-more/350-ai-tools/100-cursor.mdx, content/200-orm/800-more/350-ai-tools/300-windsurf.mdx, content/200-orm/800-more/350-ai-tools/400-github-copilot.mdx
Removed recommendations to use Prisma middleware for cross-cutting concerns and metrics; adjusted related wording.
Observability example change
content/200-orm/200-prisma-client/600-observability-and-logging/250-opentelemetry-tracing.mdx
Replaced new PrismaInstrumentation({ middleware: true }) with new PrismaInstrumentation() and removed middleware-specific tracing guidance.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

  • Check for broken links or references to the deleted middleware pages across the docs.
  • Verify that removal of $use() API docs doesn't leave inconsistent mentions elsewhere.
  • Confirm extension ordering text changes remain accurate and consistent with current runtime behavior.

Possibly related PRs

  • Update Datadog guide to get it working #7132 — Updates PrismaInstrumentation usage in tracing examples; closely related to the change from PrismaInstrumentation({ middleware: true }) to PrismaInstrumentation().
  • Update index.mdx #7087 — Modifies middleware documentation pages; overlaps with deletion/update of the middleware index and related guidance.
  • clerk updates #7073 — Edits the same AI-tools docs area (cursor guidance); related to removed middleware recommendations.

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 and accurately describes the main objective of the changeset: removing middleware-related documentation across multiple files in the Prisma docs.
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 db258e8 and d849203.

📒 Files selected for processing (1)
  • content/200-orm/500-reference/500-preview-features/050-client-preview-features.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • content/200-orm/500-reference/500-preview-features/050-client-preview-features.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: Cloudflare Pages
  • GitHub Check: Check internal links
  • GitHub Check: runner / linkspector

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

@github-actions
Copy link
Contributor

github-actions bot commented Nov 5, 2025

Dangerous URL check

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

@github-actions
Copy link
Contributor

github-actions bot commented Nov 5, 2025

Redirect check

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

/orm/prisma-client/client-extensions/middleware/soft-delete-middleware /docs/##( TODO: Path of page that replaces deleted page )##
/orm/prisma-client/client-extensions/middleware/logging-middleware /docs/##( TODO: Path of page that replaces deleted page )##
/orm/prisma-client/client-extensions/middleware/session-data-middleware /docs/##( TODO: Path of page that replaces deleted page )##
/orm/prisma-client/client-extensions/middleware /docs/##( TODO: Path of page that replaces deleted page )##

@cloudflare-workers-and-pages
Copy link

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

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: d849203
Status: ✅  Deploy successful!
Preview URL: https://67ed9c20.docs-51g.pages.dev
Branch Preview URL: https://dc-5043-remove-middleware.docs-51g.pages.dev

View logs

@github-actions
Copy link
Contributor

github-actions bot commented Nov 5, 2025

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes to avoid unnecessary requests, and speed up consecutive runs.

📊 Results Overview

Status Count
🔍 Total 2398
✅ Successful 2118
⏳ Timeouts 2
🔀 Redirected 256
👻 Excluded 21
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 1

Errors per input

Errors in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/02-introduction-to-data-types.mdx

Errors in 250-postgres/400-query-optimization/300-recommendations/600-avoid-db-money.mdx

Redirects per input

Redirects in 100-getting-started/01-quickstart-prismaPostgres.mdx

Redirects in 100-getting-started/01-quickstart-sqlite.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases-typescript-prismaPostgres.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-node-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-node-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-typescript-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-typescript-prismaPostgres.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-typescript-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/300-next-steps.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb-node-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb-typescript-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb/100-connect-your-database-node-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb/100-connect-your-database-typescript-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb/300-next-steps.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-node-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-node-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-typescript-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-typescript-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/300-next-steps.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/120-mongodb-node-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/120-mongodb-typescript-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/120-mongodb/300-next-steps.mdx

Redirects in 100-getting-started/03-prisma-postgres/100-from-the-cli.mdx

Redirects in 100-getting-started/03-prisma-postgres/110-import-from-existing-database-postgresql.mdx

Redirects in 100-getting-started/03-prisma-postgres/115-import-from-existing-database-mysql.mdx

Redirects in 100-getting-started/03-prisma-postgres/120-upgrade-from-early-access.mdx

Redirects in 200-orm/050-overview/100-introduction/200-why-prisma.mdx

Redirects in 200-orm/050-overview/100-introduction/250-should-you-use-prisma.mdx

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

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

Redirects in 200-orm/050-overview/300-prisma-in-your-stack/03-fullstack.mdx

Redirects in 200-orm/050-overview/500-databases/200-database-drivers.mdx

Redirects in 200-orm/050-overview/500-databases/300-postgresql.mdx

Redirects in 200-orm/050-overview/500-databases/400-mysql.mdx

Redirects in 200-orm/050-overview/500-databases/600-mongodb.mdx

Redirects in 200-orm/050-overview/500-databases/800-sql-server/020-sql-server-local.mdx

Redirects in 200-orm/050-overview/500-databases/850-planetscale.mdx

Redirects in 200-orm/050-overview/500-databases/880-supabase.mdx

Redirects in 200-orm/050-overview/500-databases/890-neon.mdx

Redirects in 200-orm/050-overview/500-databases/900-turso.mdx

Redirects in 200-orm/050-overview/500-databases/950-cloudflare-d1.mdx

Redirects in 200-orm/100-prisma-schema/10-overview/03-generators.mdx

Redirects in 200-orm/100-prisma-schema/10-overview/04-location.mdx

Redirects in 200-orm/100-prisma-schema/20-data-model/10-models.mdx

Redirects in 200-orm/100-prisma-schema/20-data-model/40-views.mdx

Redirects in 200-orm/200-prisma-client/000-setup-and-configuration/010-generating-prisma-client.mdx

Redirects in 200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/200-pgbouncer.mdx

Redirects in 200-orm/200-prisma-client/000-setup-and-configuration/200-read-replicas.mdx

Redirects in 200-orm/200-prisma-client/100-queries/050-filtering-and-sorting.mdx

Redirects in 200-orm/200-prisma-client/100-queries/058-transactions.mdx

Redirects in 200-orm/200-prisma-client/100-queries/061-custom-validation.mdx

Redirects in 200-orm/200-prisma-client/100-queries/070-case-sensitivity.mdx

Redirects in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx

Redirects in 200-orm/200-prisma-client/200-special-fields-and-types/index.mdx

Redirects in 200-orm/200-prisma-client/300-client-extensions/200-extension-examples.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/101-traditional/225-deploy-to-render.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/101-traditional/325-deploy-to-railway.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/201-serverless/300-deploy-to-vercel.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/201-serverless/500-deploy-to-netlify.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/100-overview.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/450-deploy-to-cloudflare.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/485-deploy-to-vercel.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/550-deploy-to-deno-deploy.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/550-deploy-database-changes-with-prisma-migrate.mdx

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

Redirects in 200-orm/500-reference/100-prisma-schema-reference.mdx

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

Redirects in 200-orm/500-reference/400-system-requirements.mdx

Redirects in 200-orm/500-reference/500-preview-features/050-client-preview-features.mdx

Redirects in 200-orm/800-more/100-under-the-hood/100-engines.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/200-upgrading-versions/600-upgrading-to-prisma-5/index.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/03-upgrading-the-prisma-layer-mysql.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/03-upgrading-the-prisma-layer-postgresql.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/04-upgrading-nexus-prisma-to-nexus.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/05-upgrading-prisma-binding-to-nexus.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/08-upgrade-from-mongodb-beta.mdx

Redirects in 200-orm/800-more/350-ai-tools/100-cursor.mdx

Redirects in 200-orm/800-more/350-ai-tools/300-windsurf.mdx

Redirects in 200-orm/800-more/350-ai-tools/400-github-copilot.mdx

Redirects in 200-orm/800-more/350-ai-tools/index.mdx

Redirects in 200-orm/800-more/400-comparisons/01-prisma-and-typeorm.mdx

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

Redirects in 200-orm/800-more/500-development-environment/200-editor-setup.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/03-date-types.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/04-connecting-to-postgresql-databases.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/800-check-constraints.mdx

Redirects in 250-postgres/100-introduction/250-overview.mdx

Redirects in 250-postgres/300-database/350-caching.mdx

Redirects in 250-postgres/300-database/525-postgres-extensions.mdx

Redirects in 250-postgres/350-integrations/100-netlify.mdx

Redirects in 250-postgres/350-integrations/200-vercel.mdx

Redirects in 250-postgres/350-integrations/300-idx.mdx

Redirects in 250-postgres/350-integrations/400-mcp-server.mdx

@github-actions
Copy link
Contributor

github-actions bot commented Nov 5, 2025

🍈 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 2397
✅ Successful 2117
⏳ Timeouts 0
🔀 Redirected 257
👻 Excluded 21
❓ Unknown 0
🚫 Errors 1
⛔ Unsupported 1

Errors per input

Errors in 250-postgres/400-query-optimization/300-recommendations/600-avoid-db-money.mdx

Redirects per input

Redirects in 100-getting-started/01-quickstart-prismaPostgres.mdx

Redirects in 100-getting-started/01-quickstart-sqlite.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases-typescript-prismaPostgres.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-node-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-node-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-typescript-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-typescript-prismaPostgres.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/100-connect-your-database-typescript-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/110-relational-databases/300-next-steps.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb-node-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb-typescript-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb/100-connect-your-database-node-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb/100-connect-your-database-typescript-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/100-start-from-scratch/120-mongodb/300-next-steps.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-node-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-node-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-typescript-planetscale.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/100-connect-your-database-typescript-sqlserver.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/110-relational-databases/300-next-steps.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/120-mongodb-node-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/120-mongodb-typescript-mongodb.mdx

Redirects in 100-getting-started/02-setup-prisma/200-add-to-existing-project/120-mongodb/300-next-steps.mdx

Redirects in 100-getting-started/03-prisma-postgres/100-from-the-cli.mdx

Redirects in 100-getting-started/03-prisma-postgres/110-import-from-existing-database-postgresql.mdx

Redirects in 100-getting-started/03-prisma-postgres/115-import-from-existing-database-mysql.mdx

Redirects in 100-getting-started/03-prisma-postgres/120-upgrade-from-early-access.mdx

Redirects in 200-orm/050-overview/100-introduction/200-why-prisma.mdx

Redirects in 200-orm/050-overview/100-introduction/250-should-you-use-prisma.mdx

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

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

Redirects in 200-orm/050-overview/300-prisma-in-your-stack/03-fullstack.mdx

Redirects in 200-orm/050-overview/500-databases/200-database-drivers.mdx

Redirects in 200-orm/050-overview/500-databases/300-postgresql.mdx

Redirects in 200-orm/050-overview/500-databases/400-mysql.mdx

Redirects in 200-orm/050-overview/500-databases/600-mongodb.mdx

Redirects in 200-orm/050-overview/500-databases/800-sql-server/020-sql-server-local.mdx

Redirects in 200-orm/050-overview/500-databases/850-planetscale.mdx

Redirects in 200-orm/050-overview/500-databases/880-supabase.mdx

Redirects in 200-orm/050-overview/500-databases/890-neon.mdx

Redirects in 200-orm/050-overview/500-databases/900-turso.mdx

Redirects in 200-orm/050-overview/500-databases/950-cloudflare-d1.mdx

Redirects in 200-orm/100-prisma-schema/10-overview/03-generators.mdx

Redirects in 200-orm/100-prisma-schema/10-overview/04-location.mdx

Redirects in 200-orm/100-prisma-schema/20-data-model/10-models.mdx

Redirects in 200-orm/100-prisma-schema/20-data-model/40-views.mdx

Redirects in 200-orm/200-prisma-client/000-setup-and-configuration/010-generating-prisma-client.mdx

Redirects in 200-orm/200-prisma-client/000-setup-and-configuration/050-databases-connections/200-pgbouncer.mdx

Redirects in 200-orm/200-prisma-client/000-setup-and-configuration/200-read-replicas.mdx

Redirects in 200-orm/200-prisma-client/100-queries/050-filtering-and-sorting.mdx

Redirects in 200-orm/200-prisma-client/100-queries/058-transactions.mdx

Redirects in 200-orm/200-prisma-client/100-queries/061-custom-validation.mdx

Redirects in 200-orm/200-prisma-client/100-queries/070-case-sensitivity.mdx

Redirects in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx

Redirects in 200-orm/200-prisma-client/200-special-fields-and-types/index.mdx

Redirects in 200-orm/200-prisma-client/300-client-extensions/200-extension-examples.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/101-traditional/225-deploy-to-render.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/101-traditional/325-deploy-to-railway.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/201-serverless/300-deploy-to-vercel.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/201-serverless/500-deploy-to-netlify.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/100-overview.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/450-deploy-to-cloudflare.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/485-deploy-to-vercel.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/301-edge/550-deploy-to-deno-deploy.mdx

Redirects in 200-orm/200-prisma-client/500-deployment/550-deploy-database-changes-with-prisma-migrate.mdx

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

Redirects in 200-orm/500-reference/100-prisma-schema-reference.mdx

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

Redirects in 200-orm/500-reference/400-system-requirements.mdx

Redirects in 200-orm/500-reference/500-preview-features/050-client-preview-features.mdx

Redirects in 200-orm/800-more/100-under-the-hood/100-engines.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/200-upgrading-versions/600-upgrading-to-prisma-5/index.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/03-upgrading-the-prisma-layer-mysql.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/03-upgrading-the-prisma-layer-postgresql.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/04-upgrading-nexus-prisma-to-nexus.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/05-upgrading-prisma-binding-to-nexus.mdx

Redirects in 200-orm/800-more/300-upgrade-guides/800-upgrade-from-prisma-1/08-upgrade-from-mongodb-beta.mdx

Redirects in 200-orm/800-more/350-ai-tools/100-cursor.mdx

Redirects in 200-orm/800-more/350-ai-tools/300-windsurf.mdx

Redirects in 200-orm/800-more/350-ai-tools/400-github-copilot.mdx

Redirects in 200-orm/800-more/350-ai-tools/index.mdx

Redirects in 200-orm/800-more/400-comparisons/01-prisma-and-typeorm.mdx

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

Redirects in 200-orm/800-more/500-development-environment/200-editor-setup.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/03-date-types.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/04-connecting-to-postgresql-databases.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx

Redirects in 200-orm/800-more/600-help-and-troubleshooting/800-check-constraints.mdx

Redirects in 250-postgres/100-introduction/250-overview.mdx

Redirects in 250-postgres/300-database/350-caching.mdx

Redirects in 250-postgres/300-database/525-postgres-extensions.mdx

Redirects in 250-postgres/350-integrations/100-netlify.mdx

Redirects in 250-postgres/350-integrations/200-vercel.mdx

Redirects in 250-postgres/350-integrations/300-idx.mdx

Redirects in 250-postgres/350-integrations/400-mcp-server.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 87eba65 and a7b5744.

📒 Files selected for processing (15)
  • content/200-orm/200-prisma-client/100-queries/100-query-optimization-performance.mdx (0 hunks)
  • content/200-orm/200-prisma-client/300-client-extensions/120-query.mdx (0 hunks)
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/100-soft-delete-middleware.mdx (0 hunks)
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/200-logging-middleware.mdx (0 hunks)
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/300-session-data-middleware.mdx (0 hunks)
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/index.mdx (0 hunks)
  • content/200-orm/200-prisma-client/300-client-extensions/index.mdx (0 hunks)
  • content/200-orm/500-reference/050-prisma-client-reference.mdx (0 hunks)
  • content/200-orm/500-reference/500-preview-features/050-client-preview-features.mdx (1 hunks)
  • content/200-orm/800-more/350-ai-tools/100-cursor.mdx (0 hunks)
  • content/200-orm/800-more/350-ai-tools/300-windsurf.mdx (0 hunks)
  • content/200-orm/800-more/350-ai-tools/400-github-copilot.mdx (0 hunks)
  • content/250-postgres/400-query-optimization/100-setup.mdx (1 hunks)
  • content/300-accelerate/200-getting-started.mdx (1 hunks)
  • content/700-optimize/200-getting-started.mdx (1 hunks)
💤 Files with no reviewable changes (11)
  • content/200-orm/200-prisma-client/300-client-extensions/120-query.mdx
  • content/200-orm/800-more/350-ai-tools/300-windsurf.mdx
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/100-soft-delete-middleware.mdx
  • content/200-orm/800-more/350-ai-tools/100-cursor.mdx
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/index.mdx
  • content/200-orm/500-reference/050-prisma-client-reference.mdx
  • content/200-orm/200-prisma-client/300-client-extensions/index.mdx
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/200-logging-middleware.mdx
  • content/200-orm/200-prisma-client/100-queries/100-query-optimization-performance.mdx
  • content/200-orm/800-more/350-ai-tools/400-github-copilot.mdx
  • content/200-orm/200-prisma-client/300-client-extensions/500-middleware/300-session-data-middleware.mdx
🧰 Additional context used
🧠 Learnings (2)
📚 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/500-reference/500-preview-features/050-client-preview-features.mdx
📚 Learning: 2025-08-11T09:40:55.237Z
Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

Applied to files:

  • content/200-orm/500-reference/500-preview-features/050-client-preview-features.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). (4)
  • GitHub Check: Check links
  • GitHub Check: Check internal links
  • GitHub Check: runner / linkspector
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (3)
content/300-accelerate/200-getting-started.mdx (1)

151-159: Heading and documentation update align with middleware removal.

The removal of "or middleware" from the section heading and updated guidance for extension ordering (Optimize before Accelerate) is consistent with the PR's objective to deprecate middleware patterns in favor of extensions.

content/250-postgres/400-query-optimization/100-setup.mdx (1)

78-86: Multiline extension chaining improves readability.

The switch from single-line to multiline chaining (.$extends() calls on separate lines) makes the extension application order more explicit and the code easier to read. The removal of "or middleware" from the heading aligns with the PR's objectives.

content/700-optimize/200-getting-started.mdx (1)

73-81: Clear extension precedence guidance and improved workflow steps.

The explicit statement that Accelerate should be applied after Optimize establishes clear precedence rules. The updated steps (lines 87–89) provide more granular guidance by explicitly mentioning the recording start/stop actions, making the workflow clearer for users.

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/200-prisma-client/300-client-extensions/120-query.mdx (1)

18-18: Minor: Consider varying sentence structure for better readability.

The opening sentence of this paragraph begins with "You can," as does the next sentence. While not technically incorrect, varying the sentence structure slightly would improve the flow and readability of the documentation.

Consider restructuring one of these sentences. For example:

- You can use Prisma Client extensions `query` component to create independent clients with customized behavior. You can bind one client to a specific filter or user, and another client to another filter or user.
+ You can use Prisma Client extensions `query` component to create independent clients with customized behavior. By binding one client to a specific filter or user and another to a different one, you can achieve granular control.
📜 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 a7b5744 and db258e8.

📒 Files selected for processing (2)
  • content/200-orm/200-prisma-client/300-client-extensions/120-query.mdx (1 hunks)
  • content/200-orm/200-prisma-client/600-observability-and-logging/250-opentelemetry-tracing.mdx (1 hunks)
🧰 Additional context used
🧠 Learnings (3)
📓 Common learnings
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.
📚 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/200-prisma-client/300-client-extensions/120-query.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/200-prisma-client/300-client-extensions/120-query.mdx
🪛 LanguageTool
content/200-orm/200-prisma-client/300-client-extensions/120-query.mdx

[style] ~18-~18: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...ndent clients with customized behavior. You can bind one client to a specific filte...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

⏰ 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). (4)
  • GitHub Check: Check links
  • GitHub Check: runner / linkspector
  • GitHub Check: Check internal links
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (1)
content/200-orm/200-prisma-client/600-observability-and-logging/250-opentelemetry-tracing.mdx (1)

127-186: LGTM! The removal of the middleware parameter from PrismaInstrumentation() is cleanly applied across both configuration options, maintaining consistency and clarity.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 6, 2025

🍈 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 2396
✅ Successful 2117
⏳ Timeouts 0
🔀 Redirected 256
👻 Excluded 21
❓ Unknown 0
🚫 Errors 1
⛔ Unsupported 1

Errors per input

Errors in 200-orm/800-more/600-help-and-troubleshooting/050-dataguide/02-introduction-to-data-types.mdx

@github-actions
Copy link
Contributor

github-actions bot commented Nov 6, 2025

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes to avoid unnecessary requests, and speed up consecutive runs.

📊 Results Overview

Status Count
🔍 Total 2396
✅ Successful 2117
⏳ Timeouts 0
🔀 Redirected 257
👻 Excluded 21
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 1

@github-actions
Copy link
Contributor

github-actions bot commented Nov 6, 2025

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes to avoid unnecessary requests, and speed up consecutive runs.

📊 Results Overview

Status Count
🔍 Total 2396
✅ Successful 2112
⏳ Timeouts 0
🔀 Redirected 262
👻 Excluded 21
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 1

@aidankmcalister aidankmcalister merged commit 3bf085d into prisma-7 Nov 7, 2025
7 checks passed
@aidankmcalister aidankmcalister deleted the DC-5043-remove-middleware branch November 7, 2025 14:00
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