From ae32f1eb91652c27f120eafc810da4f9d56c74fc Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Mon, 16 Mar 2026 17:46:01 -0400
Subject: [PATCH 1/5] Rename and reposition enterprise file

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/{enterprise/index.mdx => enterprise.mdx} | 8 ++++----
 docusaurus.config.ts                                   | 2 +-
 sidebars.ts                                            | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)
 rename docs/toolhive/{enterprise/index.mdx => enterprise.mdx} (98%)

diff --git a/docs/toolhive/enterprise/index.mdx b/docs/toolhive/enterprise.mdx
similarity index 98%
rename from docs/toolhive/enterprise/index.mdx
rename to docs/toolhive/enterprise.mdx
index 003e3546..86c87954 100644
--- a/docs/toolhive/enterprise/index.mdx
+++ b/docs/toolhive/enterprise.mdx
@@ -285,7 +285,7 @@ by running each server in its own container with least-privilege permissions,
 encrypting credentials at rest, and tracing every tool call via OpenTelemetry.
 Stacklok Enterprise adds centralized governance, IdP-backed authentication, and
 audit logging for teams running MCP at scale across their organization.
-[Explore the core concepts](../concepts) to dig deeper into how ToolHive works.
+[Explore the core concepts](./concepts/) to dig deeper into how ToolHive works.
 
 </details>
 
@@ -297,7 +297,7 @@ MCP. This includes Claude Code, GitHub Copilot, Cursor, Windsurf, VS Code, Zed,
 Cline, Continue, Roo Code, Goose, LM Studio, OpenAI Codex, and many more. Most
 clients support automatic configuration so developers can connect without manual
 setup.
-[See the full client compatibility reference](../reference/client-compatibility)
+[See the full client compatibility reference](./reference/client-compatibility.mdx)
 for the complete list.
 
 </details>
@@ -310,7 +310,7 @@ servers maintained by Stacklok. From there, you have full control to add your
 own servers from public package managers, Docker images, remote URLs, or build a
 private registry tailored to your organization. You are never limited to
 Stacklok's catalog.
-[See how to run MCP servers in Kubernetes](../guides-k8s/run-mcp-k8s) for the
+[See how to run MCP servers in Kubernetes](./guides-k8s/run-mcp-k8s.mdx) for the
 full details.
 
 </details>
@@ -324,6 +324,6 @@ full details.
 ToolHive Community is free, open source, and the best way to evaluate MCP before
 moving to production.
 
-[Get started with ToolHive Community →](/toolhive)
+[Get started with ToolHive Community →](./index.mdx)
 
 :::
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 5172580d..48005504 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -292,7 +292,7 @@ const config: Config = {
           position: 'left',
         },
         {
-          to: '/toolhive/enterprise',
+          to: 'toolhive/enterprise',
           label: 'Enterprise',
           position: 'left',
         },
diff --git a/sidebars.ts b/sidebars.ts
index f10a18bf..f0f84762 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -280,10 +280,10 @@ const sidebars: SidebarsConfig = {
       items: [{ type: 'autogenerated', dirName: 'toolhive/guides-mcp' }],
     },
 
-    'toolhive/enterprise/index',
     'toolhive/reference/client-compatibility',
     'toolhive/reference/index',
     'toolhive/faq',
+    'toolhive/enterprise',
     'toolhive/support',
     'toolhive/contributing',
   ],

From d546519cd417e5ab0074781ae2c327d1dabc01df Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Mon, 16 Mar 2026 17:49:32 -0400
Subject: [PATCH 2/5] Replace raw h2 with Heading component

- Maintains Docusaurus ref checking while not adding to ToC

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/enterprise.mdx | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/toolhive/enterprise.mdx b/docs/toolhive/enterprise.mdx
index 86c87954..674d5c38 100644
--- a/docs/toolhive/enterprise.mdx
+++ b/docs/toolhive/enterprise.mdx
@@ -1,17 +1,21 @@
 ---
 title: Stacklok Enterprise
 description: Stacklok Enterprise offerings for ToolHive
-hide_title: false
 ---
 
 import HubSpotForm from '@site/src/components/HubSpotForm';
+import Heading from '@theme/Heading';
+
+<Heading as='h2'>
+  A hardened and production-ready distribution of ToolHive Community
+</Heading>
 
-<h2>A hardened and production-ready distribution of ToolHive Community</h2>
 Securely scale MCP servers across your enterprise with Stacklok Enterprise's
 signed binaries, hardened images, formal semantic versioning, backported
 security patches, and turnkey identity provider integrations. Kubernetes native
 and LLM agnostic. Self-hosted in your environment, governed by your policies, no
 vendor lock-in.
+
 <HubSpotForm
   anchorId='schedule-a-demo'
   title='Schedule a Demo'
@@ -94,7 +98,7 @@ them.
 | Hardened container base images (Chainguard or equiv.)    |     —     |     ✓      |
 | Proactive notification of vulnerabilities                |     —     |     ✓      |
 | CVEs addressed within SLO with responsible disclosure    |     —     |     ✓      |
-| All Sev 0–3 vulnerabilities backported as patch updates  |     —     |     ✓      |
+| All Sev 0-3 vulnerabilities backported as patch updates  |     —     |     ✓      |
 
 ### Auth, identity & governance
 

From f5747d807c3abd777b86d7986b5bf37fe92de475 Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Mon, 16 Mar 2026 17:49:45 -0400
Subject: [PATCH 3/5] Fix custom list bullet alignment

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/enterprise.mdx                 | 45 ++++++++------------
 src/components/BrandedList/index.tsx         | 26 +++++++++++
 src/components/BrandedList/styles.module.css | 35 +++++++++++++++
 src/css/custom.css                           | 29 -------------
 4 files changed, 78 insertions(+), 57 deletions(-)
 create mode 100644 src/components/BrandedList/index.tsx
 create mode 100644 src/components/BrandedList/styles.module.css

diff --git a/docs/toolhive/enterprise.mdx b/docs/toolhive/enterprise.mdx
index 674d5c38..84fc011b 100644
--- a/docs/toolhive/enterprise.mdx
+++ b/docs/toolhive/enterprise.mdx
@@ -5,6 +5,7 @@ description: Stacklok Enterprise offerings for ToolHive
 
 import HubSpotForm from '@site/src/components/HubSpotForm';
 import Heading from '@theme/Heading';
+import BrandedList from '@site/src/components/BrandedList';
 
 <Heading as='h2'>
   A hardened and production-ready distribution of ToolHive Community
@@ -40,34 +41,22 @@ vendor lock-in.
 
 Teams typically move to Stacklok Enterprise when they hit one of these walls:
 
-<ul className='stacklok-icon-list'>
-  <li>
-    Developers are bringing their own MCP servers to work — shadow AI is
-    spreading and there is no central control
-  </li>
-  <li>
-    Your organization has multiple coding assistants and AI agents that need
-    access to business context
-  </li>
-  <li>
-    Your security or compliance team is asking how MCP servers are
-    authenticated, audited, and patched
-  </li>
-  <li>
-    You need SSO and IdP integration (Okta, Entra ID) across your organization
-  </li>
-  <li>
-    You are running MCP in production and need SLA-backed support for incidents
-  </li>
-  <li>
-    You need centralized governance and policy enforcement across multiple teams
-    or business units
-  </li>
-  <li>
-    Your environment requires a semantically versioned, supply-chain-attested
-    distribution rather than continuous rolling release
-  </li>
-</ul>
+<BrandedList>
+
+- Developers are bringing their own MCP servers to work — shadow AI is spreading
+  and there is no central control
+- Your organization has multiple coding assistants and AI agents that need
+  access to business context
+- Your security or compliance team is asking how MCP servers are authenticated,
+  audited, and patched
+- You need SSO and IdP integration (Okta, Entra ID) across your organization
+- You are running MCP in production and need SLA-backed support for incidents
+- You need centralized governance and policy enforcement across multiple teams
+  or business units
+- Your environment requires a semantically versioned, supply-chain-attested
+  distribution rather than continuous rolling release
+
+</BrandedList>
 
 Recognizing these challenges in your organization?
 [Schedule a demo](#schedule-a-demo) to see how Stacklok Enterprise addresses
diff --git a/src/components/BrandedList/index.tsx b/src/components/BrandedList/index.tsx
new file mode 100644
index 00000000..32597a76
--- /dev/null
+++ b/src/components/BrandedList/index.tsx
@@ -0,0 +1,26 @@
+// SPDX-FileCopyrightText: Copyright 2026 Stacklok, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/*
+ * Renders a markdown unordered list with the Stacklok brand symbol as the
+ * bullet icon. Use as a block wrapper around a standard markdown list in MDX:
+ *
+ *   <BrandedList>
+ *   - item one
+ *   - item two
+ *   </BrandedList>
+ *
+ * MDX processes the markdown into a <ul> inside the wrapper <div>, which the
+ * CSS module targets via `.list ul li`.
+ */
+
+import React, { ReactNode } from 'react';
+import styles from './styles.module.css';
+
+interface BrandedListProps {
+  children: ReactNode;
+}
+
+export default function BrandedList({ children }: BrandedListProps) {
+  return <div className={styles.list}>{children}</div>;
+}
diff --git a/src/components/BrandedList/styles.module.css b/src/components/BrandedList/styles.module.css
new file mode 100644
index 00000000..a65b7ea1
--- /dev/null
+++ b/src/components/BrandedList/styles.module.css
@@ -0,0 +1,35 @@
+/*
+  SPDX-FileCopyrightText: Copyright 2026 Stacklok, Inc.
+  SPDX-License-Identifier: Apache-2.0
+*/
+
+.list ul {
+  list-style: none;
+  padding-left: 0;
+}
+
+.list ul li {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.75rem;
+}
+
+.list ul li p {
+  margin: 0;
+}
+
+.list ul li::before {
+  content: '';
+  background-image: url('/img/logos/stacklok-symbol-light-green.svg');
+  background-size: contain;
+  background-repeat: no-repeat;
+  height: 1rem;
+  width: 1rem;
+  flex-shrink: 0;
+  display: inline-block;
+}
+
+:global([data-theme='light']) .list ul li::before {
+  background-image: url('/img/logos/stacklok-symbol-dark-green.svg');
+}
diff --git a/src/css/custom.css b/src/css/custom.css
index e3098738..798700d2 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -443,35 +443,6 @@ details summary:hover {
   color: var(--ifm-color-primary);
 }
 
-/* Icon bullet list using the Stacklok brand symbol as a custom bullet */
-.stacklok-icon-list {
-  list-style: none;
-  padding-left: 0;
-}
-
-.stacklok-icon-list li {
-  display: flex;
-  align-items: flex-start;
-  gap: 0.5rem;
-  margin-bottom: 0.75rem;
-}
-
-.stacklok-icon-list li::before {
-  content: '';
-  background-image: url('/img/logos/stacklok-symbol-light-green.svg');
-  background-size: contain;
-  background-repeat: no-repeat;
-  height: 1rem;
-  width: 1rem;
-  margin-top: 0.2rem;
-  flex-shrink: 0;
-  display: inline-block;
-}
-
-[data-theme='light'] .stacklok-icon-list li::before {
-  background-image: url('/img/logos/stacklok-symbol-dark-green.svg');
-}
-
 /* HubSpot form styling for Enterprise page */
 
 .hs-form-private .hs-input {

From 6a9c6decdddfb819865c5eb3dc9d18a886232f9d Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Mon, 16 Mar 2026 18:24:45 -0400
Subject: [PATCH 4/5] Fix heading anchor in HubSpotForm

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/enterprise.mdx         |  2 +-
 src/components/HubSpotForm/index.tsx | 32 ++++++++++++++++++++++------
 2 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/docs/toolhive/enterprise.mdx b/docs/toolhive/enterprise.mdx
index 84fc011b..b949af93 100644
--- a/docs/toolhive/enterprise.mdx
+++ b/docs/toolhive/enterprise.mdx
@@ -19,7 +19,7 @@ vendor lock-in.
 
 <HubSpotForm
   anchorId='schedule-a-demo'
-  title='Schedule a Demo'
+  title='Schedule a demo'
   subtitle='See how teams go from evaluation to production in under 60 days'
   portalId='42544743'
   formId='9e42c0ba-c41b-4d22-bacc-86d75854da06'
diff --git a/src/components/HubSpotForm/index.tsx b/src/components/HubSpotForm/index.tsx
index b51e50d1..48c06ed8 100644
--- a/src/components/HubSpotForm/index.tsx
+++ b/src/components/HubSpotForm/index.tsx
@@ -1,7 +1,21 @@
-// SPDX-FileCopyrightText: Copyright 2025 Stacklok, Inc.
+// SPDX-FileCopyrightText: Copyright 2026 Stacklok, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
+/*
+ * Renders an embedded HubSpot form using the HubSpot Forms API. The embed
+ * script is loaded lazily on mount and shared across multiple instances on the
+ * same page. Tracks submission state to trigger HubSpot's own confirmation
+ * message in place of the form.
+ *
+ * When `title` is provided, the form is wrapped in a branded card with an
+ * optional `subtitle`. Supply `anchorId` to make the title a named anchor
+ * target for in-page links (e.g. a CTA linking to "#schedule-a-demo").
+ * The title renders as a `<Heading>` so Docusaurus recognizes the anchor
+ * during its build-time link validation.
+ */
+
 import React, { useEffect, useRef, useState } from 'react';
+import Heading from '@theme/Heading';
 
 interface HubSpotFormProps {
   portalId: string;
@@ -72,7 +86,6 @@ export default function HubSpotForm({
     return (
       <div style={{ textAlign: 'center' }}>
         <div
-          id={anchorId}
           style={{
             textAlign: 'center',
             backgroundColor: 'var(--stacklok-green-leaf)',
@@ -81,14 +94,21 @@ export default function HubSpotForm({
             borderRadius: '24px',
             display: 'inline-block',
             width: 'auto',
-            scrollMarginTop: anchorId ? '7rem' : undefined,
           }}
         >
-          <span
-            style={{ display: 'block', fontWeight: '700', fontSize: '1.25rem' }}
+          <Heading
+            as='h2'
+            id={anchorId}
+            style={{
+              display: 'block',
+              fontWeight: '700',
+              fontSize: '1.25rem',
+              color: 'inherit',
+              scrollMarginTop: anchorId ? '9rem' : undefined,
+            }}
           >
             {title}
-          </span>
+          </Heading>
           {subtitle && (
             <span
               style={{

From 601297a22ef84c23828726dc1ce1614af979a087 Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Mon, 16 Mar 2026 18:25:11 -0400
Subject: [PATCH 5/5] Update enterprise section to reference new page

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/support.mdx | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/docs/toolhive/support.mdx b/docs/toolhive/support.mdx
index 9f09894e..31c477cc 100644
--- a/docs/toolhive/support.mdx
+++ b/docs/toolhive/support.mdx
@@ -111,9 +111,7 @@ This information helps the team diagnose and fix issues more quickly.
 
 ## Enterprise support
 
-For organizations that need dedicated support, custom integrations, or
-assistance with large-scale deployments, enterprise support is available. Learn
-more about the Stacklok MCP Platform and enterprise offerings on the
-[Stacklok website](https://stacklok.com/platform/) or
-[request a demo](https://stacklok.com/demo/) to see how the platform can meet
-your organization's needs.
+For organizations that need an enterprise distribution of ToolHive with
+dedicated support, custom integrations, or assistance with large-scale
+deployments, see the [Stacklok Enterprise](./enterprise.mdx) page to learn more
+and get in touch.