fix(fern): pin frozen version content via git archive at publish time

Frozen versions pointed at ../../docs/ (the live docs directory),
serving current content for all versions. Switch to the git archive
pattern used by NVSentinel: at publish time, extract docs from each
version's git tag into fern/versions/vX.Y.Z-content/ directories.

- v0.3.0.yml paths now reference v0.3.0-content/ (populated at CI time)
- Publish workflow: fetch-tags + git archive step extracts docs per tag
- .gitignore excludes *-content/ dirs from the repo

Signed-off-by: Pete MacKinnon <mackinnon.pd@gmail.com>

Author: pdmack

.github/workflows/publish-fern-docs.yml

@@ -42,6 +42,21 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-tags: true
+
+      - name: Checkout frozen version content
+        run: |
+          for version_file in fern/versions/v*.yml; do
+            version=$(basename "$version_file" .yml)
+            if git rev-parse "$version" >/dev/null 2>&1; then
+              mkdir -p "fern/versions/${version}-content"
+              git archive "$version" -- docs/ | tar -x --strip-components=1 -C "fern/versions/${version}-content"
+              echo "Extracted docs from $version"
+            else
+              echo "::warning::Tag $version not found — skipping content checkout"
+            fi
+          done
 
       - name: Setup Node.js
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0

fern/versions/.gitignore

@@ -0,0 +1 @@
+*-content/

fern/versions/v0.3.0.yml

@@ -5,48 +5,48 @@ navigation:
   - section: Getting Started
     contents:
       - page: Overview
-        path: ../../docs/overview.md
+        path: v0.3.0-content/overview.md
       - page: Install on Kubernetes
-        path: ../../docs/get-started/quickstart-k8s.md
+        path: v0.3.0-content/get-started/quickstart-k8s.md
       - page: Install on Slurm
-        path: ../../docs/get-started/quickstart-slurm.md
+        path: v0.3.0-content/get-started/quickstart-slurm.md
 
   - section: Architecture
     contents:
       - page: Architecture
-        path: ../../docs/architecture.md
+        path: v0.3.0-content/architecture.md
       - page: Config and API
-        path: ../../docs/api.md
+        path: v0.3.0-content/api.md
 
   - section: Providers
     contents:
       - page: AWS
-        path: ../../docs/providers/aws.md
+        path: v0.3.0-content/providers/aws.md
       - page: GCP
-        path: ../../docs/providers/gcp.md
+        path: v0.3.0-content/providers/gcp.md
       - page: OCI
-        path: ../../docs/providers/oci.md
+        path: v0.3.0-content/providers/oci.md
       - page: Nebius
-        path: ../../docs/providers/nebius.md
+        path: v0.3.0-content/providers/nebius.md
       - page: InfiniBand
-        path: ../../docs/providers/infiniband.md
+        path: v0.3.0-content/providers/infiniband.md
       - page: NetQ
-        path: ../../docs/providers/netq.md
+        path: v0.3.0-content/providers/netq.md
       - page: DRA
-        path: ../../docs/providers/dra.md
+        path: v0.3.0-content/providers/dra.md
       - page: Test
-        path: ../../docs/providers/test.md
+        path: v0.3.0-content/providers/test.md
 
   - section: Engines
     contents:
       - page: SLURM
-        path: ../../docs/engines/slurm.md
+        path: v0.3.0-content/engines/slurm.md
       - page: Kubernetes
-        path: ../../docs/engines/k8s.md
+        path: v0.3.0-content/engines/k8s.md
       - page: Slinky
-        path: ../../docs/engines/slinky.md
+        path: v0.3.0-content/engines/slinky.md
 
   - section: Reference
     contents:
       - page: Node Labels and Annotations
-        path: ../../docs/reference/node-labels.md
+        path: v0.3.0-content/reference/node-labels.md