Add docsTeamMetrics frontmatter and plumb through to analytics events (#60662)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Sarah Schneider <sarahs@github.com>
Co-authored-by: Sarah Schneider <sarahs@users.noreply.github.com>
Co-authored-by: Kevin Heis <heiskr@users.noreply.github.com>

Author: 4 people

src/events/components/events.ts

@@ -120,6 +120,7 @@ export function sendEvent<T extends EventType>({
       page_document_type: getMetaContent('page-document-type'),
       page_type: getMetaContent('page-type'),
       content_type: getMetaContent('page-content-type'),
+      docs_team_metrics: getMetaContent('docs-team-metrics') || undefined,
       status: Number(getMetaContent('status') || 0),
       is_logged_in: isLoggedIn(),
       octo_client_id: getOctoClientId(),

src/events/lib/schema.ts

@@ -106,6 +106,11 @@ const context = {
       description: 'Optional content type from the content frontmatter (EDI content models).',
       enum: contentTypesEnum,
     },
+    docs_team_metrics: {
+      type: 'string',
+      description:
+        'Optional comma-separated list of docsTeamMetrics frontmatter values for internal analytics filtering.',
+    },
     status: {
       type: 'number',
       description: 'The HTTP response status code of the main page HTML.',

src/events/types.ts

@@ -37,6 +37,7 @@ export type EventProps = {
     page_document_type: string
     page_type: string
     content_type: string
+    docs_team_metrics?: string
     status: number
     is_logged_in: boolean
     dotcom_user: string

src/frame/components/DefaultLayout.tsx

@@ -162,6 +162,9 @@ export const DefaultLayout = (props: Props) => {
         )}
         {page.contentType && <meta name="page-content-type" content={page.contentType} />}
         {page.documentType && <meta name="page-document-type" content={page.documentType} />}
+        {page.docsTeamMetrics && page.docsTeamMetrics.length > 0 && (
+          <meta name="docs-team-metrics" content={page.docsTeamMetrics.join(',')} />
+        )}
         {status && <meta name="status" content={status.toString()} />}
 
         {/* OpenGraph data */}

src/frame/components/context/MainContext.tsx

@@ -125,6 +125,7 @@ export type MainContextT = {
     hidden: boolean
     noEarlyAccessBanner: boolean
     applicableVersions: string[]
+    docsTeamMetrics?: string[]
   } | null
   relativePath?: string
   sidebarTree?: ProductTreeNode | null
@@ -227,6 +228,7 @@ export const getMainContext = async (req: any, res: any): Promise<MainContextT>
       applicableVersions: req.context.page?.permalinks.map((obj: any) => obj.pageVersion) || [],
       hidden: req.context.page.hidden || false,
       noEarlyAccessBanner: req.context.page.noEarlyAccessBanner || false,
+      docsTeamMetrics: req.context.page.docsTeamMetrics || undefined,
     }) ||
     null
 

src/types/types.ts

@@ -345,6 +345,7 @@ export type Page = {
   industry?: string[]
   sidebarLink?: SidebarLink
   contentType?: string
+  docsTeamMetrics?: string[]
   children?: string[]
 }