Add versioned docs infrastructure and fix broken site URL

.devcontainer/CHANGELOG.md

@@ -18,6 +18,8 @@
   - Merged setup variables (`.env` flags) into the Environment Variables reference
   - Merged `.secrets` file authentication docs into the Configuration page
 - Removed `.devcontainer/docs/` directory — all content now lives in the docs site
+- **Versioned docs infrastructure** — installed `starlight-versions` plugin; no archived versions yet, first snapshot will be taken when v3 development begins
+- **Fixed docs site URL** — updated `site` to `https://codeforge.core-directive.com` and removed `/CodeForge` base path (custom domain serves from root)
 
 ### Fixed
 

docs/astro.config.mjs

@@ -9,10 +9,11 @@ import starlightLinksValidator from "starlight-links-validator";
 import starlightLlmsTxt from "starlight-llms-txt";
 import starlightScrollToTop from "starlight-scroll-to-top";
 import starlightSidebarTopics from "starlight-sidebar-topics";
+// Uncomment when activating versioned docs (see plugin comment below)
+// import starlightVersions from "starlight-versions";
 
 export default defineConfig({
-	site: "https://anexileddev.github.io",
-	base: "/CodeForge",
+	site: "https://codeforge.core-directive.com",
 	integrations: [
 		// astro-mermaid MUST be registered BEFORE starlight
 		astroMermaid(),
@@ -44,22 +45,22 @@ export default defineConfig({
 					tag: "meta",
 					attrs: {
 						name: "og:image",
-						content: "/CodeForge/og-image.png",
+						content: "/og-image.png",
 					},
 				},
 				{
 					tag: "link",
 					attrs: {
 						rel: "icon",
 						type: "image/png",
-						href: "/CodeForge/favicon.png",
+						href: "/favicon.png",
 					},
 				},
 				{
 					tag: "link",
 					attrs: {
 						rel: "apple-touch-icon",
-						href: "/CodeForge/apple-touch-icon.png",
+						href: "/apple-touch-icon.png",
 					},
 				},
 				{
@@ -70,6 +71,17 @@ export default defineConfig({
 				},
 			],
 			plugins: [
+				// ── Versioned docs (activate when archiving the first version) ──
+				// starlightVersions requires at least one archived version.
+				// When v3 development begins, uncomment and add v2 as the first entry:
+				//
+				//   starlightVersions({
+				//     versions: [{ slug: "2.0", label: "v2.0" }],
+				//     current: { label: "v3" },
+				//   }),
+				//
+				// Then run `npm run dev` — the plugin archives current docs as v2.0.
+				// See: https://github.com/HiDeoo/starlight-versions
 				starlightSidebarTopics([
 					{
 						label: "Getting Started",

docs/package.json

@@ -26,6 +26,7 @@
     "starlight-scroll-to-top": "^0.4.0",
     "starlight-sidebar-topics": "^0.6.2",
     "starlight-tags": "^0.4.0",
+    "starlight-versions": "^0.7.0",
     "tailwindcss": "^4.2.1"
   }
 }

docs/src/components/Header.astro

@@ -1,17 +1,17 @@
 ---
+import LanguageSelect from "virtual:starlight/components/LanguageSelect";
+import Search from "virtual:starlight/components/Search";
+import SiteTitle from "virtual:starlight/components/SiteTitle";
+import SocialIcons from "virtual:starlight/components/SocialIcons";
+import ThemeSelect from "virtual:starlight/components/ThemeSelect";
 /**
  * Custom Header — extends Starlight's default Header with a "Docs" button.
  */
-import config from 'virtual:starlight/user-config';
-
-import LanguageSelect from 'virtual:starlight/components/LanguageSelect';
-import Search from 'virtual:starlight/components/Search';
-import SiteTitle from 'virtual:starlight/components/SiteTitle';
-import SocialIcons from 'virtual:starlight/components/SocialIcons';
-import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
+import config from "virtual:starlight/user-config";
 
 const shouldRenderSearch =
-	config.pagefind || config.components.Search !== '@astrojs/starlight/components/Search.astro';
+	config.pagefind ||
+	config.components.Search !== "@astrojs/starlight/components/Search.astro";
 ---
 
 <div class="header">
@@ -22,7 +22,7 @@ const shouldRenderSearch =
 		{shouldRenderSearch && <Search />}
 	</div>
 	<div class="sl-hidden md:sl-flex print:hidden right-group">
-		<a href="/CodeForge/getting-started/" class="docs-link">Docs</a>
+		<a href="/getting-started/" class="docs-link">Docs</a>
 		<div class="sl-flex social-icons">
 			<SocialIcons />
 		</div>

docs/src/components/Hero.astro

@@ -6,8 +6,8 @@
  *
  * Receives Starlight's Hero props but renders entirely custom content.
  */
-import FeatureCard from './FeatureCard.astro';
-import InstallCommand from './InstallCommand.astro';
+import FeatureCard from "./FeatureCard.astro";
+import InstallCommand from "./InstallCommand.astro";
 
 /* Accept Starlight's props to satisfy the component override contract */
 const _props = Astro.props;
@@ -44,7 +44,7 @@ const _props = Astro.props;
 
 		{/* ---- CTA buttons ---- */}
 		<div class="hero-actions">
-			<a href="/CodeForge/getting-started/" class="hero-btn hero-btn--primary">
+			<a href="/getting-started/" class="hero-btn hero-btn--primary">
 				Get Started
 				<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"/></svg>
 			</a>

docs/src/content.config.ts

@@ -1,7 +1,9 @@
-import { defineCollection } from 'astro:content';
-import { docsLoader } from '@astrojs/starlight/loaders';
-import { docsSchema } from '@astrojs/starlight/schema';
+import { defineCollection } from "astro:content";
+import { docsLoader } from "@astrojs/starlight/loaders";
+import { docsSchema } from "@astrojs/starlight/schema";
+import { docsVersionsLoader } from "starlight-versions/loader";
 
 export const collections = {
 	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+	versions: defineCollection({ loader: docsVersionsLoader() }),
 };

docs/src/content/docs/index.mdx

@@ -6,7 +6,7 @@ hero:
   tagline: Your AI dev environment, battle-tested.
   actions:
     - text: Get Started
-      link: /CodeForge/getting-started/
+      link: /getting-started/
       icon: right-arrow
       variant: primary
     - text: View on GitHub