fix(docs): broken links

aidankmcalister · aidankmcalister · commit 561b4926abbc · 2026-04-01T15:21:59.000-04:00
diff --git a/apps/docs/content/docs.v6/guides/multiple-databases.mdx b/apps/docs/content/docs.v6/guides/multiple-databases.mdx
@@ -426,7 +426,7 @@ Deploy your app by following these steps:
    :::note
    Replace `<your-username>` and `<repository-name>` with your GitHub username and the name of your repository.
    :::
-2. Log in to [Vercel](https://vercel.com/) and navigate to your [Dashboard](https://vercel.com/docs/dashboard-features).
+2. Log in to [Vercel](https://vercel.com/) and navigate to your [Dashboard](https://vercel.com/docs/deployments).
 3. Create a new project. Follow Vercel's [Import an existing project](https://vercel.com/docs/getting-started-with-vercel/import) guide, but stop at [step 3](https://vercel.com/docs/getting-started-with-vercel/import#optionally-configure-any-settings) where you will configure environment variables _before_ clicking **Deploy**.
 4. Configure the `DATABASE_URL` environment variable:
    1. Expand the **Environment variables** section.
diff --git a/apps/docs/content/docs.v6/orm/more/ai-tools/windsurf.mdx b/apps/docs/content/docs.v6/orm/more/ai-tools/windsurf.mdx
@@ -39,7 +39,7 @@ You can also add the Prisma MCP server manually. Learn more about how you can ad
 
 ## Defining project-specific rules with `.windsurfrules`
 
-The [`.windsurfrules` file](https://docs.windsurf.com/windsurf/memories#windsurfrules) in Windsurf allows you to enforce best practices and development standards tailored to your Prisma project. By defining clear and consistent rules, you can ensure that Windsurf generates clean, maintainable, and project-specific code with minimal manual adjustments.
+The [`.windsurfrules` file](https://docs.windsurf.com/windsurf/cascade/memories) in Windsurf allows you to enforce best practices and development standards tailored to your Prisma project. By defining clear and consistent rules, you can ensure that Windsurf generates clean, maintainable, and project-specific code with minimal manual adjustments.
 
 To implement these rules, create a `.windsurfrules` file in the root of your project. Below is an example configuration:
 
diff --git a/apps/docs/content/docs.v6/orm/more/comparisons/prisma-and-drizzle.mdx b/apps/docs/content/docs.v6/orm/more/comparisons/prisma-and-drizzle.mdx
@@ -334,7 +334,7 @@ Prisma isn’t just an ORM—it’s a complete type-safe data toolkit:
 
 Both Drizzle and Prisma ORM support multiple and different kinds of databases. Drizzle achieves this support through driver implementations created by Drizzle, which integrate with existing third-party database drivers.
 
-Prisma ORM has begun adding support for [third-party database drivers](https://www.prisma.io/blog/serverless-database-drivers-KML1ehXORxZV), but primarily uses [built-in drivers](/v6/orm/more/internals/engines#the-query-engine-at-runtime) to communicate with an underlying database. Prisma also defaults connections to TLS, which improves security.
+Prisma ORM has begun adding support for [third-party database drivers](https://www.prisma.io/blog/serverless-database-drivers-kml1ehxorxzv), but primarily uses [built-in drivers](/v6/orm/more/internals/engines#the-query-engine-at-runtime) to communicate with an underlying database. Prisma also defaults connections to TLS, which improves security.
 
 Additionally, Prisma ORM supports CockroachDB, Microsoft SQL Server, and MongoDB, which Drizzle does not currently support. Prisma ORM also offers the [relation mode](/v6/orm/prisma-schema/data-model/relations/relation-mode) that allows Prisma ORM to emulate foreign key constraints for those database engines that do not support it. Drizzle currently supports Cloudflare D1, `bun:sqlite`, and SQLite via HTTP Proxy, which Prisma ORM currently does not.
 
diff --git a/apps/docs/content/docs.v6/orm/prisma-client/testing/integration-testing.mdx b/apps/docs/content/docs.v6/orm/prisma-client/testing/integration-testing.mdx
@@ -10,7 +10,7 @@ Integration tests focus on testing how separate parts of the program work togeth
 
 One way to simulate a real world environment is to use [Docker](https://www.docker.com/get-started/) to encapsulate a database and some test data. This can be spun up and torn down with the tests and so operate as an isolated environment away from your production databases.
 
-> **Note:** This [blog post](https://www.prisma.io/blog/testing-series-2-xPhjjmIEsM) offers a comprehensive guide on setting up an integration testing environment and writing integration tests against a real database, providing valuable insights for those looking to explore this topic.
+> **Note:** This [blog post](https://www.prisma.io/blog/testing-series-2-xphjjmiesm) offers a comprehensive guide on setting up an integration testing environment and writing integration tests against a real database, providing valuable insights for those looking to explore this topic.
 
 ## Prerequisites
 
@@ -445,7 +445,7 @@ You can add some scripts to your projects `package.json` file which will setup t
 
 :::warning
 
-If the test doesn't work for you, you'll need to ensure the test database is properly set up and ready, as explained in this [blog](https://www.prisma.io/blog/testing-series-3-aBUyF8nxAn#make-the-script-wait-until-the-database-server-is-ready).
+If the test doesn't work for you, you'll need to ensure the test database is properly set up and ready, as explained in this [blog](https://www.prisma.io/blog/testing-series-3-abuyf8nxan#make-the-script-wait-until-the-database-server-is-ready).
 
 :::
 
diff --git a/apps/docs/content/docs.v6/orm/prisma-client/testing/unit-testing.mdx b/apps/docs/content/docs.v6/orm/prisma-client/testing/unit-testing.mdx
@@ -18,7 +18,7 @@ A single test should focus on how your function logic handles different inputs (
 
 This means that you should aim to remove as many dependencies as possible, such as external services and databases, to keep the tests and their environments as lightweight as possible.
 
-> **Note**: This [blog post](https://www.prisma.io/blog/testing-series-2-xPhjjmIEsM) provides a comprehensive guide to implementing unit testing in your Express project with Prisma ORM. If you're looking to delve into this topic, be sure to give it a read!
+> **Note**: This [blog post](https://www.prisma.io/blog/testing-series-2-xphjjmiesm) provides a comprehensive guide to implementing unit testing in your Express project with Prisma ORM. If you're looking to delve into this topic, be sure to give it a read!
 
 ## Prerequisites
 
diff --git a/apps/docs/content/docs.v6/postgres/integrations/mcp-server.mdx b/apps/docs/content/docs.v6/postgres/integrations/mcp-server.mdx
@@ -249,7 +249,7 @@ If you want the Prisma MCP server to be available only in specific Cursor projec
 
 ### Windsurf
 
-To learn more about Windsurf's MCP integration, check out the [Windsurf MCP docs](https://docs.codeium.com/windsurf/mcp).
+To learn more about Windsurf's MCP integration, check out the [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp).
 
 #### Add via Windsurf MCP Plugin Store (Recommended)
 
diff --git a/apps/docs/content/docs/ai/tools/mcp-server.mdx b/apps/docs/content/docs/ai/tools/mcp-server.mdx
@@ -250,7 +250,7 @@ If you want the Prisma MCP server to be available only in specific Cursor projec
 
 ### Windsurf
 
-To learn more about Windsurf's MCP integration, check out the [Windsurf MCP docs](https://docs.codeium.com/windsurf/mcp).
+To learn more about Windsurf's MCP integration, check out the [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp).
 
 #### Add via Windsurf MCP Plugin Store (Recommended)
 
diff --git a/apps/docs/content/docs/ai/tools/windsurf.mdx b/apps/docs/content/docs/ai/tools/windsurf.mdx
@@ -39,7 +39,7 @@ You can also add the Prisma MCP server manually. Learn more about how you can ad
 
 ## Defining project-specific rules with `.windsurfrules`
 
-The [`.windsurfrules` file](https://docs.windsurf.com/windsurf/memories#windsurfrules) in Windsurf allows you to enforce best practices and development standards tailored to your Prisma project. By defining clear and consistent rules, you can ensure that Windsurf generates clean, maintainable, and project-specific code with minimal manual adjustments.
+The [`.windsurfrules` file](https://docs.windsurf.com/windsurf/cascade/memories) in Windsurf allows you to enforce best practices and development standards tailored to your Prisma project. By defining clear and consistent rules, you can ensure that Windsurf generates clean, maintainable, and project-specific code with minimal manual adjustments.
 
 To implement these rules, create a `.windsurfrules` file in the root of your project. Below is an example configuration:
 
diff --git a/apps/docs/content/docs/guides/database/multiple-databases.mdx b/apps/docs/content/docs/guides/database/multiple-databases.mdx
@@ -425,7 +425,7 @@ Deploy your app by following these steps:
    :::note
    Replace `<your-username>` and `<repository-name>` with your GitHub username and the name of your repository.
    :::
-2. Log in to [Vercel](https://vercel.com/) and navigate to your [Dashboard](https://vercel.com/docs/dashboard-features).
+2. Log in to [Vercel](https://vercel.com/) and navigate to your [Dashboard](https://vercel.com/docs/deployments).
 3. Create a new project. Follow Vercel's [Import an existing project](https://vercel.com/docs/getting-started-with-vercel/import) guide, but stop at [step 3](https://vercel.com/docs/getting-started-with-vercel/import#optionally-configure-any-settings) where you will configure environment variables _before_ clicking **Deploy**.
 4. Configure the `DATABASE_URL` environment variable:
    1. Expand the **Environment variables** section.
diff --git a/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx b/apps/docs/content/docs/orm/more/comparisons/prisma-and-drizzle.mdx
@@ -326,7 +326,7 @@ Prisma isn’t just an ORM—it’s a complete type-safe data toolkit:
 
 Both Drizzle and Prisma ORM support multiple and different kinds of databases. Drizzle achieves this support through driver implementations created by Drizzle, which integrate with existing third-party database drivers.
 
-Prisma ORM has begun adding support for [third-party database drivers](https://www.prisma.io/blog/serverless-database-drivers-KML1ehXORxZV). Prisma also defaults connections to TLS, which improves security.
+Prisma ORM has begun adding support for [third-party database drivers](https://www.prisma.io/blog/serverless-database-drivers-kml1ehxorxzv). Prisma also defaults connections to TLS, which improves security.
 
 Additionally, Prisma ORM supports CockroachDB, Microsoft SQL Server, and MongoDB, which Drizzle does not currently support. Prisma ORM also offers the [relation mode](/orm/prisma-schema/data-model/relations/relation-mode) that allows Prisma ORM to emulate foreign key constraints for those database engines that do not support it. Drizzle currently supports Cloudflare D1, `bun:sqlite`, and SQLite via HTTP Proxy, which Prisma ORM currently does not.
 
diff --git a/apps/docs/content/docs/orm/prisma-client/deployment/edge/deploy-to-deno-deploy.mdx b/apps/docs/content/docs/orm/prisma-client/deployment/edge/deploy-to-deno-deploy.mdx
@@ -346,7 +346,7 @@ prisma-deno-deploy/
 
 ### Next steps
 
-- Add authentication using [Deno KV](https://deno.com/kv) for sessions
+- Add authentication using [Deno KV](https://docs.deno.com/deploy/reference/deno_kv/) for sessions
 - Add request validation with [Zod](https://zod.dev/)
 - Explore [Prisma Client extensions](/orm/prisma-client/client-extensions) for custom functionality
 - Set up [Prisma Migrate](/orm/prisma-migrate) for schema versioning in production
diff --git a/apps/docs/content/docs/orm/prisma-client/testing/integration-testing.mdx b/apps/docs/content/docs/orm/prisma-client/testing/integration-testing.mdx
@@ -10,7 +10,7 @@ Integration tests focus on testing how separate parts of the program work togeth
 
 One way to simulate a real world environment is to use [Docker](https://www.docker.com/get-started/) to encapsulate a database and some test data. This can be spun up and torn down with the tests and so operate as an isolated environment away from your production databases.
 
-> **Note:** This [blog post](https://www.prisma.io/blog/testing-series-2-xPhjjmIEsM) offers a comprehensive guide on setting up an integration testing environment and writing integration tests against a real database, providing valuable insights for those looking to explore this topic.
+> **Note:** This [blog post](https://www.prisma.io/blog/testing-series-2-xphjjmiesm) offers a comprehensive guide on setting up an integration testing environment and writing integration tests against a real database, providing valuable insights for those looking to explore this topic.
 
 ## Prerequisites
 
@@ -435,7 +435,7 @@ You can add some scripts to your projects `package.json` file which will setup t
 
 :::warning
 
-If the test doesn't work for you, you'll need to ensure the test database is properly set up and ready, as explained in this [blog](https://www.prisma.io/blog/testing-series-3-aBUyF8nxAn#make-the-script-wait-until-the-database-server-is-ready).
+If the test doesn't work for you, you'll need to ensure the test database is properly set up and ready, as explained in this [blog](https://www.prisma.io/blog/testing-series-3-abuyf8nxan#make-the-script-wait-until-the-database-server-is-ready).
 
 :::
 
diff --git a/apps/docs/content/docs/orm/prisma-client/testing/unit-testing.mdx b/apps/docs/content/docs/orm/prisma-client/testing/unit-testing.mdx
@@ -18,7 +18,7 @@ A single test should focus on how your function logic handles different inputs (
 
 This means that you should aim to remove as many dependencies as possible, such as external services and databases, to keep the tests and their environments as lightweight as possible.
 
-> **Note**: This [blog post](https://www.prisma.io/blog/testing-series-2-xPhjjmIEsM) provides a comprehensive guide to implementing unit testing in your Express project with Prisma ORM. If you're looking to delve into this topic, be sure to give it a read!
+> **Note**: This [blog post](https://www.prisma.io/blog/testing-series-2-xphjjmiesm) provides a comprehensive guide to implementing unit testing in your Express project with Prisma ORM. If you're looking to delve into this topic, be sure to give it a read!
 
 ## Prerequisites
 
diff --git a/apps/docs/scripts/lint-external-links.ts b/apps/docs/scripts/lint-external-links.ts
@@ -12,6 +12,10 @@ const TIMEOUT_MS = 10_000;
 const MAX_CONCURRENCY = 15;
 const ACCEPTED_STATUSES = new Set([403, 429]);
 
+// Links that are known to work correctly but cannot be verified by an HTTP
+// checker (e.g. deeplinks that trigger a native app to open).
+const IGNORED_URLS = new Set(["https://pris.ly/cursor-deeplink"]);
+
 const IMAGE_EXTENSIONS = new Set([
   ".png",
   ".jpg",
@@ -263,6 +267,7 @@ async function main(): Promise<void> {
   const failed: FailedResult[] = [];
 
   await runWithConcurrency(uniqueUrls, MAX_CONCURRENCY, async (url) => {
+    if (IGNORED_URLS.has(url)) return;
     const result = await checkUrl(url);
     if (result.ok) return;
 
