feat(perf): Update onPostBuild step to generate performance on-boarding docs

Author: dashed

src/gatsby/onPostBuild.ts

@@ -67,6 +67,37 @@ export default async ({ graphql }) => {
   await writeJson(output, nodes, platformRegistry);
 };
 
+const parsePathSlug = (slug: string) => {
+  if (slug.includes("performance-onboarding")) {
+    const pathMatch = slug.match(
+      /^\/(?<platform>[^/]+)\/performance-onboarding\/(?<sub_platform>[^/]+)\/(?<step>[^/]+)\/$/
+    );
+    const { platform, sub_platform } = pathMatch.groups;
+    let step = pathMatch.groups.step;
+    step = String(step).replace(/\./g, "-");
+    let sub = `performance-onboarding-${sub_platform}-${step}`;
+
+    if (platform === pathMatch.groups.sub_platform) {
+      sub = `performance-onboarding-${step}`;
+    }
+
+    return {
+      platform,
+      sub,
+    };
+  }
+
+  const pathMatch = slug.match(/^\/([^/]+)(?:\/([^/]+))?\/$/);
+  if (!pathMatch) throw new Error("cant identify language");
+
+  const [, main, sub] = pathMatch;
+
+  return {
+    platform: main,
+    sub: sub,
+  };
+};
+
 const writeJson = async (
   path: string,
   nodes,
@@ -75,10 +106,8 @@ const writeJson = async (
   const platforms = [];
   const indexJson = {};
   nodes.forEach(node => {
-    const pathMatch = node.fields.slug.match(/^\/([^/]+)(?:\/([^/]+))?\/$/);
-    if (!pathMatch) throw new Error("cant identify language");
-    // eslint-disable-next-line no-unused-vars
-    const [, main, sub] = pathMatch;
+    const { platform: main, sub } = parsePathSlug(node.fields.slug);
+
     if (!indexJson[main]) indexJson[main] = {};
     if (!node.frontmatter.doc_link) {
       throw new Error(

src/wizard/javascript/performance-onboarding/javascript/1.install.md

@@ -0,0 +1,19 @@
+---
+name: JavaScript
+doc_link: https://docs.sentry.io/platforms/javascript/performance/
+support_level: production
+type: language
+---
+
+#### Install
+
+Install our JavaScript browser SDK using either `yarn` or `npm`:
+
+```bash {tabTitle: ESM}
+# Using yarn
+yarn add @sentry/browser @sentry/tracing
+# Using npm
+npm install --save @sentry/browser @sentry/tracing
+```
+
+We also support alternate [installation methods](/platforms/javascript/install/).

src/wizard/javascript/performance-onboarding/javascript/2.configure.md

@@ -0,0 +1,33 @@
+---
+name: JavaScript
+doc_link: https://docs.sentry.io/platforms/javascript/performance/
+support_level: production
+type: language
+---
+
+#### Configure
+
+Configuration should happen as early as possible in your application's lifecycle.
+
+Once this is done, Sentry's JavaScript SDK captures all unhandled exceptions and transactions.
+
+```javascript
+import * as Sentry from "@sentry/browser";
+import { BrowserTracing } from "@sentry/tracing";
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  integrations: [new BrowserTracing()],
+
+  // Set tracesSampleRate to 1.0 to capture 100%
+  // of transactions for performance monitoring.
+  // We recommend adjusting this value in production
+  tracesSampleRate: 1.0,
+});
+```
+
+We recommend adjusting the value of `tracesSampleRate` in production. Learn more about configuring sampling in our [full documentation](/platforms/javascript/configuration/sampling/).
+
+Learn more about manually capturing an error or message in our [Usage documentation](/usage/).
+
+To view and resolve the recorded error, log into [sentry.io](https://sentry.io) and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.

src/wizard/javascript/performance-onboarding/javascript/3.verify.md

@@ -0,0 +1,18 @@
+---
+name: JavaScript
+doc_link: https://docs.sentry.io/platforms/javascript/performance/
+support_level: production
+type: language
+---
+
+#### Verify
+
+This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:
+
+```javascript
+myUndefinedFunction();
+```
+
+If you're new to Sentry, use the email alert to access your account and complete a product tour.
+
+If you're an existing user and have disabled alerts, you won't receive this email.