fix(docs): carry the landing-page backlink into integration markdown

Author: waleedlatif1

apps/docs/app/[[...slug]]/page.tsx

@@ -1,7 +1,5 @@
 import type React from 'react'
 import { Children, cloneElement, isValidElement } from 'react'
-import { LANDING_SLUG_BY_DOCS_SLUG } from '@sim/deployment-config/integration-docs'
-import { INTEGRATION_METADATA } from '@sim/deployment-config/integration-metadata'
 import { highlight } from 'fumadocs-core/highlight'
 import { findNeighbour } from 'fumadocs-core/page-tree'
 import type { ApiPageProps } from 'fumadocs-openapi/ui'
@@ -19,28 +17,14 @@ import { APIExampleSelector } from '@/components/ui/api-example-selector'
 import { CodeBlock } from '@/components/ui/code-block'
 import { Heading } from '@/components/ui/heading'
 import { ResponseSection } from '@/components/ui/response-section'
+import { getIntegrationLandingPage, INTEGRATION_LANDING_LABEL } from '@/lib/integration-landing'
 import { getApiSpecContent, getAuthenticatedCodeSamples, openapi } from '@/lib/openapi'
 import { simShikiOptions } from '@/lib/shiki-theme'
 import { type PageData, source } from '@/lib/source'
-import { DOCS_BASE_URL, SIM_SITE_URL } from '@/lib/urls'
+import { DOCS_BASE_URL } from '@/lib/urls'
 
 const BASE_URL = DOCS_BASE_URL
 
-const INTEGRATION_NAME_BY_LANDING_SLUG = new Map(
-  INTEGRATION_METADATA.map((integration) => [integration.slug, integration.name])
-)
-
-/** The landing page a docs integration page (`/integrations/<docs slug>`) links to, if any. */
-function getIntegrationLandingPage(slug: string[] | undefined) {
-  if (slug?.length !== 2 || slug[0] !== 'integrations') return undefined
-  const landingSlug = LANDING_SLUG_BY_DOCS_SLUG.get(slug[1])
-  if (!landingSlug) return undefined
-  return {
-    name: INTEGRATION_NAME_BY_LANDING_SLUG.get(landingSlug) ?? landingSlug,
-    url: `${SIM_SITE_URL}/integrations/${landingSlug}`,
-  }
-}
-
 /**
  * Most pages close with a `## Next` / `## Next steps` grid of onward links.
  * That heading is navigation, not content, so it is kept out of the table of
@@ -286,10 +270,8 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
         <DocsBody>
           {integrationLandingPage && (
             <p>
-              Use cases and templates:{' '}
-              <a href={integrationLandingPage.url}>
-                {integrationLandingPage.name} integration for AI agents
-              </a>
+              {INTEGRATION_LANDING_LABEL}{' '}
+              <a href={integrationLandingPage.url}>{integrationLandingPage.title}</a>
             </p>
           )}
           <MDX

apps/docs/lib/integration-landing.ts

@@ -0,0 +1,22 @@
+import { LANDING_SLUG_BY_DOCS_SLUG } from '@sim/deployment-config/integration-docs'
+import { INTEGRATION_METADATA } from '@sim/deployment-config/integration-metadata'
+import { SIM_SITE_URL } from '@/lib/urls'
+
+/** Lead-in for the docs page's link to its landing page, shared by the HTML and markdown forms. */
+export const INTEGRATION_LANDING_LABEL = 'Use cases and templates:'
+
+const INTEGRATION_NAME_BY_LANDING_SLUG = new Map(
+  INTEGRATION_METADATA.map((integration) => [integration.slug, integration.name])
+)
+
+/** The landing page a docs integration page (`/integrations/<docs slug>`) links to, if any. */
+export function getIntegrationLandingPage(slugs: readonly string[] | undefined) {
+  if (slugs?.length !== 2 || slugs[0] !== 'integrations') return undefined
+  const landingSlug = LANDING_SLUG_BY_DOCS_SLUG.get(slugs[1])
+  if (!landingSlug) return undefined
+  const name = INTEGRATION_NAME_BY_LANDING_SLUG.get(landingSlug) ?? landingSlug
+  return {
+    title: `${name} integration for AI agents`,
+    url: `${SIM_SITE_URL}/integrations/${landingSlug}`,
+  }
+}

apps/docs/lib/llms.ts

@@ -1,5 +1,6 @@
 import type { InferPageType } from 'fumadocs-core/source'
 import type { ApiPageProps } from 'fumadocs-openapi/ui'
+import { getIntegrationLandingPage, INTEGRATION_LANDING_LABEL } from '@/lib/integration-landing'
 import { getApiSpecContent } from '@/lib/openapi'
 import type { PageData, source } from '@/lib/source'
 
@@ -55,7 +56,11 @@ export async function getLLMText(page: InferPageType<typeof source>) {
 
   if (typeof data.getText !== 'function') return ''
   const processed = await data.getText('processed')
+  const landingPage = getIntegrationLandingPage(page.slugs)
+  const landingLink = landingPage
+    ? `${INTEGRATION_LANDING_LABEL} [${landingPage.title}](${landingPage.url})\n\n`
+    : ''
   return `${heading}
 
-${compactTables(processed)}`
+${landingLink}${compactTables(processed)}`
 }