Versioned docs

.gitmodules

@@ -1,4 +1,12 @@
-[submodule "opentofu-repo"]
-	path = opentofu-repo
+[submodule "opentofu-repo/main"]
+	path = opentofu-repo/main
 	url = https://github.com/opentofu/opentofu
-	branch = v1.6
+	branch = main
+[submodule "opentofu-repo/v1.6"]
+	path = opentofu-repo/v1.6
+	url = https://github.com/opentofu/opentofu
+	branch = v1.6
+[submodule "opentofu-repo/v1.7"]
+	path = opentofu-repo/v1.7
+	url = https://github.com/opentofu/opentofu
+	branch = v1.7

docusaurus.config.ts

@@ -101,23 +101,39 @@ const config: Config = {
           customCss: [require.resolve("./src/css/custom.css")],
         },
         docs: {
-          sidebarPath: require.resolve("./sidebars.js"),
-          path: "opentofu-repo/website/docs",
+          includeCurrentVersion: false,
+          lastVersion: 'v1.6',
+          docVersionRootComponent: "@theme/DocVersionRoot",
+          versions: {
+            "v1.6": {
+              label: "1.6.x",
+              path: ""
+            },
+            "v1.7": {
+              label: "1.7.x",
+              path: "next",
+              banner: "unreleased",
+              noIndex: true
+            }/*,
+            "main": {
+              label: "1.8.x",
+              path: "next",
+              banner: "unreleased",
+              noIndex: true
+            }*/
+          },
           routeBasePath: "/docs",
-          editUrl: ({ docPath }) => {
+          editUrl: ({ version, docPath }) => {
             // Remove the edit link from the documentation index page
             // TODO: remove after moving the page to the main OpenTofu repo
             if (docPath === "index.mdx") {
-              return `https://github.com/opentofu/opentofu.org/edit/main/docs/${docPath}`;
+              return `https://github.com/opentofu/opentofu.org/edit/${version}/docs/${docPath}`;
             }
 
-            return `https://github.com/opentofu/opentofu/edit/main/website/docs/${docPath}`;
+            return `https://github.com/opentofu/opentofu/edit/${version}/website/docs/${docPath}`;
           },
         },
         blog: false,
-        gtag: {
-          trackingID: "G-NKLFR0FNQZ",
-        },
       } satisfies Preset.Options,
     ],
   ],
@@ -183,14 +199,15 @@ const config: Config = {
       respectPrefersColorScheme: false,
     },
     docs: {
+      versionPersistence: "none",
       sidebar: {
         autoCollapseCategories: true,
       },
     },
     announcementBar: {
       id: "opentofu-ga",
       content:
-        'OpenTofu 1.7.0-beta1 is now availabe &mdash; <a target="_blank" rel="noopener noreferrer" href="/blog/opentofu-1-7-0-beta1/">learn more</a>.',
+        'OpenTofu 1.7.0-rc1 is now availabe &mdash; <a target="_blank" rel="noopener noreferrer" href="https://github.com/opentofu/opentofu/releases/tag/v1.7.0-rc1">learn more</a>.',
       backgroundColor: "#ffda18",
       textColor: "#1b1d20",
       isCloseable: false,
@@ -259,27 +276,16 @@ const config: Config = {
           position: "left",
           items: [
             {
-              type: "doc",
-              label: "Introduction",
-              docId: "intro/index",
-            },
-            {
-              type: "doc",
-              label: "CLI",
-              docId: "cli/index",
-            },
-            {
-              type: "doc",
-              label: "Language",
-              docId: "language/index",
+              label: "v1.6.x (current)",
+              href: "/docs"
             },
             {
-              type: "doc",
-              label: "Internals",
-              docId: "internals/index",
+              label: "v1.7.x (next)",
+              href: "/docs/next"
             },
           ],
         },
+
         // TODO: This link is important but there's no design for it yet
         // {
         //   type: "dropdown",

sidebars.json

@@ -0,0 +1,8 @@
+{
+  "docs": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}

src/theme/DocItem/Layout.tsx

@@ -2,7 +2,7 @@
 import { useDoc } from "@docusaurus/theme-common/internal";
 import DocItemPaginator from "@theme/DocItem/Paginator";
 import DocVersionBanner from "@theme/DocVersionBanner";
 import DocVersionBadge from "@theme/DocVersionBadge";
 import DocItemFooter from "@theme/DocItem/Footer";
 import DocItemTOCMobile from "@theme/DocItem/TOC/Mobile";
 import DocItemTOCDesktop from "@theme/DocItem/TOC/Desktop";
@@ -29,7 +29,6 @@
 
         <article className="flex flex-col gap-4 mb-10">
           <DocBreadcrumbs />
-          <DocVersionBadge />
           {canRenderTOC && <DocItemTOCMobile />}
           <DocItemContent>{children}</DocItemContent>
           <DocItemFooter />

versioned_docs/version-main

@@ -0,0 +1 @@
+../opentofu-repo/main/website/docs

versioned_docs/version-v1.6

@@ -0,0 +1 @@
+../opentofu-repo/v1.6/website/docs

versioned_docs/version-v1.7

@@ -0,0 +1 @@
+../opentofu-repo/v1.7/website/docs

versioned_sidebars/version-main-sidebars.json

@@ -0,0 +1,8 @@
+{
+  "docs": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}

versioned_sidebars/version-v1.6-sidebars.json

@@ -0,0 +1,8 @@
+{
+  "docs": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}

versioned_sidebars/version-v1.7-sidebars.json

@@ -0,0 +1,8 @@
+{
+  "docs": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}

versions.json

@@ -0,0 +1,5 @@
+[
+  "v1.7",
+  "v1.6",
+  "main"
+]