Update docs build to create multi-version builds.

.github/workflows/pr-docs-tests.yml

@@ -0,0 +1,39 @@
+name: Run Docs Tests
+
+on:
+  pull_request:
+
+jobs:
+  docs-tests:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os:
+          - ubuntu-24.04
+        node-version:
+          - '18'
+    steps:
+      # Install deps and cache
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Cache version builds
+        uses: actions/cache@v4
+        with:
+          key: lando-mvb-docs
+          path: docs/.vitepress/cache/@lando/mvb
+          save-always: true
+      - name: Install node ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - name: Install NPM dependencies
+        run: npm clean-install --prefer-offline --frozen-lockfile
+
+      # Run tests
+      - name: Run linter
+        run: npm run lint
+      - name: Test mvb
+        run: npm run docs:mvb
+      - name: Test build
+        run: npm run docs:build

.github/workflows/pr-linter.yml

@@ -15,9 +15,9 @@ jobs:
     steps:
       # Install deps and cache
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Install node ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           cache: npm

docs/.vitepress/config.mjs

@@ -19,6 +19,9 @@ export default defineConfig({
     ['link', {rel: 'icon', href: '/platformsh/favicon.svg', type: 'image/svg+xml'}],
   ],
   themeConfig: {
+    multiVersionBuild: {
+      satisfies: '>=1.2.0',
+    },
     sidebar: sidebar(),
   },
 });

docs/v/index.md

@@ -0,0 +1,40 @@
+---
+description: All Other documentation versions
+title: Docuverse
+contributors: false
+lastUpdated: false
+editLink: false
+next: false
+prev: false
+---
+# Docuverse
+
+<br />
+<br />
+
+<div
+  v-for="link in links"
+  :key="link.text"
+  class="version-link"
+>
+  <VPLVersionLink
+    :text="link.text"
+    :href="link.href"
+    :prerelease="link.prerelease"
+    :stable="link.stable"
+    :edge="link.edge"
+  />
+</div>
+
+<br />
+
+<div>
+  <VPLVersionLink :dev="true" :text="aliases.dev" :href="aliasLinks.dev" />
+</div>
+
+<script setup>
+import {useTags} from '@lando/vitepress-theme-default-plus';
+import {VPLCollectionPage, VPLCollectionPageSection, VPLCollectionPageTitle, VPLVersionLink} from '@lando/vitepress-theme-default-plus';
+
+const {aliases, aliasLinks, links} = useTags();
+</script>

netlify.toml

@@ -1,8 +1,21 @@
 [build]
   base = "./"
   publish = "docs/.vitepress/dist"
+  command = "npm run docs:mvb"
+
+[context.deploy-preview]
   command = "npm run docs:build"
 
+# https://github.com/munter/netlify-plugin-checklinks#readme
+[[context.deploy-preview.plugins]]
+  package = "netlify-plugin-checklinks"
+  [context.deploy-preview.plugins.inputs]
+    todoPatterns = [ "load", "CHANGELOG.html", "x.com", "twitter.com", "/v/" ]
+    skipPatterns = [ ".rss", ".gif", ".jpg" ]
+    checkExternal = true
+
+
+
 # Sets our asset optimization
 [build.processing.css]
   bundle = true
@@ -28,13 +41,7 @@
   [plugins.inputs.audits]
     output_path = "reports/lighthouse.html"
 
-# https://github.com/munter/netlify-plugin-checklinks#readme
-[[plugins]]
-  package = "netlify-plugin-checklinks"
-  [plugins.inputs]
-    todoPatterns = [ "load", "CHANGELOG.html", "x.com", "twitter.com" ]
-    skipPatterns = [ ".rss", ".gif", ".jpg" ]
-    checkExternal = true
+
 
 # We need this so preview environments and the base site look ok on their own
 [[redirects]]
@@ -44,4 +51,4 @@
 [[redirects]]
   from = "/plugins/platformsh/*"
   to = "/:splat"
-  status = 200
+  status = 200