Spike: versioned docs for Stacklok Enterprise

docs/theme-preview.mdx

@@ -30,10 +30,10 @@ By default level 2-3 headings generate the TOC on the top right
 
 ### Level 3 heading
 
-Some text within a section. [Here is a link](/theme-preview.mdx).
+Some text within a section. [Here is a link](./theme-preview.mdx).
 
 And here is some `inline code` to show how it looks, even some
-[`inline code with a link`](/theme-preview.mdx).
+[`inline code with a link`](./theme-preview.mdx).
 
 #### Level 4 heading
 
@@ -190,7 +190,7 @@ Stacklok Enterprise includes turnkey integrations for common identity providers.
 Instead of manually configuring OIDC, use the built-in Okta or Entra ID
 integration to map IdP groups directly to ToolHive roles and policy sets.
 
-[Learn more about Stacklok Enterprise](/toolhive/enterprise).
+[Learn more about Stacklok Enterprise](./toolhive/enterprise.mdx).
 
 :::
 

docs/toolhive/index.mdx

@@ -17,26 +17,12 @@ import ThemedImage from '@theme/ThemedImage';
   }}
   title='ToolHive logo'
   height={'120'}
+  style={{ 'margin-top': '1rem' }}
 />
 <br />
 
 ---
 
-<ThemedImage
-  alt='ToolHive symbol'
-  sources={{
-    light: useBaseUrl('/img/logos/toolhive-symbol-black.svg'),
-    dark: useBaseUrl('/img/logos/toolhive-symbol-white.svg'),
-  }}
-  title='ToolHive symbol'
-  height='150px'
-  style={{
-    float: 'right',
-    borderRadius: '25px',
-    margin: '1.5rem 0 1.5rem 1.5rem',
-  }}
-/>
-
 # What is ToolHive?
 
 ToolHive is an enterprise-grade open source (Apache 2.0) platform for running

docusaurus.config.ts

@@ -175,6 +175,24 @@ const config: Config = {
             keywords: ['enterprise'],
             extendDefaults: true,
           },
+          lastVersion: 'current',
+          versions: {
+            current: {
+              label: 'Latest (OSS)',
+            },
+            '1.1': {
+              label: 'Enterprise 1.1',
+              path: 'enterprise/1.1',
+              banner: 'none',
+              noIndex: true,
+            },
+            '1.0': {
+              label: 'Enterprise 1.0',
+              path: 'enterprise/1.0',
+              banner: 'none',
+              noIndex: true,
+            },
+          },
         },
         blog: {
           blogTitle: 'ToolHive Updates and Announcements',
@@ -246,32 +264,34 @@ const config: Config = {
           position: 'left',
           items: [
             {
+              type: 'doc',
+              docId: 'toolhive/index',
               label: 'Home',
-              href: '/toolhive',
-            },
-            {
-              label: 'Integrations',
-              to: 'toolhive/integrations',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/guides-ui/index',
               label: 'ToolHive UI',
-              to: 'toolhive/guides-ui',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/guides-cli/index',
               label: 'ToolHive CLI',
-              to: 'toolhive/guides-cli',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/guides-k8s/index',
               label: 'Kubernetes Operator',
-              to: 'toolhive/guides-k8s',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/guides-vmcp/index',
               label: 'Virtual MCP Server',
-              to: 'toolhive/guides-vmcp',
             },
             {
-              label: 'ToolHive Registry',
-              to: 'toolhive/guides-registry',
+              type: 'doc',
+              docId: 'toolhive/guides-registry/index',
+              label: 'Registry Server',
             },
           ],
         },
@@ -281,28 +301,34 @@ const config: Config = {
           position: 'left',
           items: [
             {
+              type: 'doc',
+              docId: 'toolhive/reference/cli/thv',
               label: 'ToolHive CLI commands',
-              to: 'toolhive/reference/cli/thv',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/reference/api',
               label: 'ToolHive API',
-              to: 'toolhive/reference/api',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/reference/crd-spec',
               label: 'ToolHive Operator CRD',
-              to: 'toolhive/reference/crd-spec',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/reference/registry-api',
               label: 'ToolHive Registry Server API',
-              to: 'toolhive/reference/registry-api',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/reference/registry-schema-toolhive',
               label: 'ToolHive registry schema',
-              to: 'toolhive/reference/registry-schema-toolhive',
             },
             {
+              type: 'doc',
+              docId: 'toolhive/reference/registry-schema-upstream',
               label: 'Upstream registry schema',
-              to: 'toolhive/reference/registry-schema-upstream',
             },
           ],
         },
@@ -312,9 +338,16 @@ const config: Config = {
           position: 'left',
         },
         {
-          to: 'toolhive/enterprise',
+          type: 'doc',
+          docId: 'toolhive/enterprise',
           label: 'Enterprise',
           position: 'left',
+          className: 'navbar-doc-link',
+        },
+        {
+          type: 'docsVersionDropdown',
+          position: 'right',
+          className: 'version-dropdown',
         },
         {
           href: 'https://github.com/stacklok',

eslint.config.mjs

@@ -52,7 +52,7 @@ export default [
 
   // Config for _partials with JSX props
   {
-    files: ['docs/**/_partials/*.mdx'],
+    files: ['docs/**/_partials/*.mdx', 'versioned_docs/**/_partials/*.mdx'],
     rules: {
       'no-unused-expressions': 'off',
       '@typescript-eslint/no-unused-expressions': 'off',