feat(js): Update profiling pages to avoid unnecessary nesting (#13352)

mydea · web-flow · commit 9f664fa8d3f0 · 2025-04-14T14:11:47.000+02:00
* feat(js): Update profiling pages to avoid unnecessary nesting

For browser/node SDKs, we do not need to have a higher-level "Profiling" page that is empty with just a single sub-page "Browser Profiling" / "Node Profiling".

Instead, now those will simply have a single "Profiling" page with the respective content. Only meta SDKs have a landing page with sub pages.

* rename to browser

* rename node

* add redirects

* avoid already renaming this
diff --git a/docs/platforms/javascript/common/profiling/index.mdx b/docs/platforms/javascript/common/profiling/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Set Up Profiling
 sidebar_order: 5000
-description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations. Get started with browser and Node.js profiling to understand your application's performance."
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations. Get started with profiling to understand your application's performance."
 notSupported:
   - javascript.bun
   - javascript.cordova
@@ -10,4 +10,4 @@ notSupported:
   - javascript.cloudflare
 ---
 
-<PageGrid />
+<PlatformContent includePath="profiling/landing-page" />
diff --git a/docs/platforms/javascript/guides/astro/profiling/browser.mdx b/docs/platforms/javascript/guides/astro/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/astro/profiling/index.mdx b/docs/platforms/javascript/guides/astro/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/astro/profiling/node.mdx b/docs/platforms/javascript/guides/astro/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/gatsby/profiling/browser.mdx b/docs/platforms/javascript/guides/gatsby/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/gatsby/profiling/index.mdx b/docs/platforms/javascript/guides/gatsby/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/gatsby/profiling/node.mdx b/docs/platforms/javascript/guides/gatsby/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/nextjs/profiling/browser.mdx b/docs/platforms/javascript/guides/nextjs/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/nextjs/profiling/index.mdx b/docs/platforms/javascript/guides/nextjs/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/nextjs/profiling/node.mdx b/docs/platforms/javascript/guides/nextjs/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/nuxt/profiling/browser.mdx b/docs/platforms/javascript/guides/nuxt/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/nuxt/profiling/index.mdx b/docs/platforms/javascript/guides/nuxt/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/nuxt/profiling/node.mdx b/docs/platforms/javascript/guides/nuxt/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/react-router/profiling/browser.mdx b/docs/platforms/javascript/guides/react-router/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/react-router/profiling/index.mdx b/docs/platforms/javascript/guides/react-router/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/react-router/profiling/node.mdx b/docs/platforms/javascript/guides/react-router/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/remix/profiling/browser.mdx b/docs/platforms/javascript/guides/remix/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/remix/profiling/index.mdx b/docs/platforms/javascript/guides/remix/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/remix/profiling/node.mdx b/docs/platforms/javascript/guides/remix/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/solidstart/profiling/browser.mdx b/docs/platforms/javascript/guides/solidstart/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/solidstart/profiling/index.mdx b/docs/platforms/javascript/guides/solidstart/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/solidstart/profiling/node.mdx b/docs/platforms/javascript/guides/solidstart/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/sveltekit/profiling/browser.mdx b/docs/platforms/javascript/guides/sveltekit/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/sveltekit/profiling/index.mdx b/docs/platforms/javascript/guides/sveltekit/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/sveltekit/profiling/node.mdx b/docs/platforms/javascript/guides/sveltekit/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/docs/platforms/javascript/guides/tanstackstart-react/profiling/browser.mdx b/docs/platforms/javascript/guides/tanstackstart-react/profiling/browser.mdx
@@ -0,0 +1,6 @@
+---
+title: Browser Profiling
+description: "Get started with Browser profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/docs/platforms/javascript/guides/tanstackstart-react/profiling/index.mdx b/docs/platforms/javascript/guides/tanstackstart-react/profiling/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Set Up Profiling
+sidebar_order: 5000
+description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+---
+
+<PageGrid />
diff --git a/docs/platforms/javascript/guides/tanstackstart-react/profiling/node.mdx b/docs/platforms/javascript/guides/tanstackstart-react/profiling/node.mdx
@@ -0,0 +1,6 @@
+---
+title: Node Profiling
+description: "Get started with Node.js profiling to understand your application's performance."
+---
+
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/platform-includes/profiling/browser-profiling/javascript.mdx b/platform-includes/profiling/browser-profiling/javascript.mdx
@@ -1,28 +1,3 @@
----
-title: Browser Profiling
-sidebar_order: 5000
-supported:
-  - javascript
-notSupported:
-  - javascript.bun
-  - javascript.cordova
-  - javascript.capacitor
-  - javascript.deno
-  - javascript.cloudflare
-  - javascript.node
-  - javascript.aws-lambda
-  - javascript.azure-functions
-  - javascript.connect
-  - javascript.express
-  - javascript.fastify
-  - javascript.gcp-functions
-  - javascript.hapi
-  - javascript.hono
-  - javascript.koa
-  - javascript.nestjs
-description: "Collect & view performance insights for JavaScript programs with Sentry's JavaScript Profiling integration."
----
-
 <Alert>
 
 Browser Profiling is currently in beta. Beta features are still in progress and may have bugs. We recognize the irony.
diff --git a/platform-includes/profiling/landing-page/javascript.mdx b/platform-includes/profiling/landing-page/javascript.mdx
@@ -0,0 +1 @@
+<PlatformContent includePath="profiling/browser-profiling" />
diff --git a/platform-includes/profiling/landing-page/javascript.node.mdx b/platform-includes/profiling/landing-page/javascript.node.mdx
@@ -0,0 +1 @@
+<PlatformContent includePath="profiling/node-profiling" />
diff --git a/platform-includes/profiling/node-profiling/javascript.mdx b/platform-includes/profiling/node-profiling/javascript.mdx
@@ -1,26 +1,3 @@
----
-title: Node Profiling
-sidebar_order: 5000
-description: "Learn more about how to configure our Profiling integration and start profiling your code."
-supported:
-  - javascript.nextjs
-  - javascript.sveltekit
-  - javascript.remix
-  - javascript.astro
-  - javascript.node
-  - javascript.aws-lambda
-  - javascript.azure-functions
-  - javascript.connect
-  - javascript.express
-  - javascript.fastify
-  - javascript.gcp-functions
-  - javascript.hapi
-  - javascript.hono
-  - javascript.koa
-  - javascript.nestjs
-  - javascript.tanstackstart-react
----
-
 By default, Sentry error events will not get trace context unless you configure the scope with the transaction, as illustrated in the example below.
 
 <Alert>
@@ -31,8 +8,21 @@ If you're adopting Profiling in a high-throughput environment, we recommend test
 
 ## Installation
 
-Node profiling is available starting in `@sentry/profiling-node` version `0.3.0`.
-You have to have the <PlatformSdkPackageName fallback="@sentry/node"/> (minimum version `7.44.1`) package installed.
+You have to install the `@sentry/profiling-node` package in addition to your main SDK package:
+
+```bash {tabTitle:npm}
+npm install @sentry/profiling-node --save
+```
+
+```bash {tabTitle:yarn}
+yarn add @sentry/profiling-node
+```
+
+```bash {tabTitle:pnpm}
+pnpm add @sentry/profiling-node
+```
+
+The version of the `@sentry/profiling-node` package must match the version of the main SDK package exactly.
 
 ## Enabling Profiling
 
diff --git a/redirects.js b/redirects.js
@@ -1057,7 +1057,7 @@ const userDocsRedirects = [
     destination: '/platforms/javascript/tracing/distributed-tracing/:path*',
   },
   {
-    source: '/platforms/javascript//tracing/instrumentation/performance-metrics/',
+    source: '/platforms/javascript/tracing/instrumentation/performance-metrics/',
     destination: '/platforms/javascript/tracing/span-metrics/',
   },
   {
@@ -1070,6 +1070,22 @@ const userDocsRedirects = [
       '/platforms/javascript//tracing/instrumentation/span-metrics/performance-metrics/',
     destination: '/platforms/javascript/tracing/span-metrics/',
   },
+  {
+    source: '/platforms/javascript/profiling/browser-profiling/',
+    destination: '/platforms/javascript/profiling/',
+  },
+  {
+    source: '/platforms/javascript/guides/:guide/profiling/browser-profiling/',
+    destination: '/platforms/javascript/guides/:guide/profiling/',
+  },
+  {
+    source: '/platforms/javascript/guides/:guide/profiling/node-profiling/',
+    destination: '/platforms/javascript/guides/:guide/profiling/',
+  },
+  {
+    source: '/platforms/javascript/guides/:guide/profiling/browser-profiling/',
+    destination: '/platforms/javascript/guides/:guide/profiling/',
+  },
   {
     source:
       '/platforms/javascript/guides/:guide/tracing/span-metrics/performance-metrics/',
