docs(cta): align analytics event with website naming scheme

Renames the docs CTA tracking event from `cta_clicked` to
`try_for_free_clicked` to match the per-event custom event names used
on the marketing website, and uses a single `location` string property
in place of the previous `surface` / `variant` / `target` / `page_path`
shape. Surface identifiers are normalized to underscored snake_case to
match the location values already used on the website.

Same change applies to the docs navbar handler that fires when a
visitor clicks the Free Developer Access link.

Author: samjulien

docs/components/layout/navbar.tsx

@@ -19,7 +19,6 @@ import DiscordIcon from "@/components/ui/icons/discord";
 import ExternalLinkIcon from "@/components/ui/icons/external-link";
 import BurgerMenuIcon from "@/components/ui/icons/burger-menu";
 import { BookOpenIcon, ScrollTextIcon } from "lucide-react";
-import posthog from "posthog-js";
 
 export interface NavbarLink {
   href: string;
@@ -130,17 +129,8 @@ const Navbar = ({ pageTree }: NavbarProps) => {
     };
   }, [isMobileSidebarOpen]);
 
-  const handleIntelligenceCtaClick = (surface: string) => {
-    try {
-      posthog.capture("cta_clicked", {
-        surface,
-        variant: "navbar",
-        target: "intelligence",
-        page_path: pathname,
-      });
-    } catch {
-      // PostHog may be blocked — never let analytics block navigation.
-    }
+  const handleTryForFreeClick = (location: string) => {
+    posthog?.capture("try_for_free_clicked", { location });
   };
 
   const handleToggleTheme = () => {
@@ -191,7 +181,7 @@ const Navbar = ({ pageTree }: NavbarProps) => {
                       onClick={
                         link.label === "Free Developer Access"
                           ? () =>
-                              handleIntelligenceCtaClick("docs:navbar:left")
+                              handleTryForFreeClick("docs_navbar_left")
                           : undefined
                       }
                       className={`h-full ${
@@ -286,7 +276,7 @@ const Navbar = ({ pageTree }: NavbarProps) => {
                   target={link.target}
                   onClick={
                     link.label === "Free Developer Access"
-                      ? () => handleIntelligenceCtaClick("docs:navbar:right")
+                      ? () => handleTryForFreeClick("docs_navbar_right")
                       : undefined
                   }
                   className={`${isIconOnlyLink ? "[@media(width>=1028px)]:hidden [@media(width<768px)]:hidden" : "hidden"} justify-center items-center w-11 h-full md:flex`}

docs/components/react/ops-platform-cta.tsx

@@ -2,7 +2,6 @@
 
 import { ArrowRight, Info, Sparkles } from "lucide-react";
 import posthog from "posthog-js";
-import { usePathname } from "next/navigation";
 import { useCallback } from "react";
 
 const DEFAULT_SIGNUP_URL = "https://dashboard.operations.copilotkit.ai/";
@@ -44,20 +43,13 @@ export function OpsPlatformCTA({
   ctaLabel = "Get Intelligence free",
   className,
 }: OpsPlatformCTAProps) {
-  const pathname = usePathname();
-
   const handleClick = useCallback(() => {
     try {
-      posthog.capture("cta_clicked", {
-        surface,
-        variant,
-        target: "intelligence",
-        page_path: pathname,
-      });
+      posthog.capture("try_for_free_clicked", { location: surface });
     } catch {
       // PostHog may be blocked by ad blockers — never let analytics block navigation.
     }
-  }, [surface, variant, pathname]);
+  }, [surface]);
 
   const href = buildHref(surface);
 

docs/content/docs/(root)/index.mdx

@@ -54,7 +54,7 @@ Look below to find right guide for your needs, whether you're starting from noth
   variant="tile"
   title="Production-ready agents on the free Developer tier"
   body="Persistent threads, observability, and the full CopilotKit platform."
-  surface="docs:home:hero-tile"
+  surface="docs_home_hero"
   className="mb-10"
 />
 

docs/content/docs/(root)/inspector.mdx

@@ -13,7 +13,7 @@ import { Callout } from "fumadocs-ui/components/callout";
   variant="inline"
   title="The threads tab needs Intelligence"
   body="When you open the Inspector, threads is the default tab. Sign up for the free Developer tier to see your conversation history."
-  surface="docs:inspector:inline"
+  surface="docs_inspector"
 />
 
 <Callout type="info">

docs/content/docs/(root)/prebuilt-components.mdx

@@ -22,7 +22,7 @@ They handle streaming, generative UI, and deep customization — so you can focu
   variant="inline"
   title="Want users to resume conversations across sessions?"
   body="Persistent threads ship with the CopilotKit platform. Try it for free."
-  surface="docs:prebuilt-components:inline"
+  surface="docs_prebuilt_components"
 />
 
 ## Get started by choosing your AI backend

docs/content/docs/(root)/quickstart.mdx

@@ -18,7 +18,7 @@ npx copilotkit@latest create
   variant="inline"
   title="Building for production?"
   body="Get persistent threads, observability, and the full CopilotKit platform. Try it for free."
-  surface="docs:quickstart:after-cli"
+  surface="docs_quickstart_after_cli"
 />
 
 ## Start from an AI backend

docs/content/docs/(root)/shared-state.mdx

@@ -31,7 +31,7 @@ Use shared state when you want to facilitate collaboration between your agent an
   variant="inline"
   title="Building stateful agents?"
   body="Persistent threads ship with the CopilotKit platform on the free Developer tier."
-  surface="docs:shared-state:inline"
+  surface="docs_shared_state"
 />
 
 ## Get started by choosing your AI backend

docs/content/docs/(root)/troubleshooting/event-inspector.mdx

@@ -18,7 +18,7 @@ Use it when:
   variant="inline"
   title="The threads tab needs Intelligence"
   body="When you open the Inspector, threads is the default tab. Sign up for the free Developer tier to see your conversation history."
-  surface="docs:troubleshooting/event-inspector:inline"
+  surface="docs_event_inspector"
 />
 
 ## Prerequisites

docs/content/docs/integrations/a2a/quickstart.mdx

@@ -33,7 +33,7 @@ import { Tabs, Tab } from "fumadocs-ui/components/tabs";
   title="Ship A2A to production"
   body="Add persistent threads, observability, and the inspector with the CopilotKit platform."
   ctaLabel="Create a free account"
-  surface="docs:a2a/quickstart:top"
+  surface="docs_a2a_quickstart"
 />
 
 ## Prerequisites

docs/content/docs/integrations/adk/quickstart.mdx

@@ -67,7 +67,7 @@ Before you begin, you'll need the following:
                 The CLI walks you through:
 
                 - **Project name**
-                - **CopilotKit platform** — persistent threads, observability, and the inspector. Choose **Yes** to scaffold a project pre-wired for the platform (the CLI walks you through sign-up, or you can [create an account](https://dashboard.operations.copilotkit.ai/?utm_source=docs&utm_medium=cta&utm_campaign=intelligence&utm_content=docs:cli-prompt) first), or **No** for a standard ADK setup.
+                - **CopilotKit platform** — persistent threads, observability, and the inspector. Choose **Yes** to scaffold a project pre-wired for the platform (the CLI walks you through sign-up, or you can [create an account](https://dashboard.operations.copilotkit.ai/?utm_source=docs&utm_medium=cta&utm_campaign=intelligence&utm_content=docs_cli_prompt) first), or **No** for a standard ADK setup.
                 - **Framework** — pick **ADK** when prompted.
             </Step>
             <Step>