diff --git a/.claude/skills/doc-tests/SKILL.md b/.claude/skills/doc-tests/SKILL.md
index 8cd587d13..d3ab40c02 100644
--- a/.claude/skills/doc-tests/SKILL.md
+++ b/.claude/skills/doc-tests/SKILL.md
@@ -73,11 +73,20 @@ Use this skill when adding tests to documentation guides in the `agentgateway/we
 title: ...
 test:
   <scenario-name>:
-  - file: content/docs/standalone/main/quickstart/<page>.md
+  - file: ${versionRoot}/quickstart/<page>.md   # same-version prereq
     path: <path-name>
+  - path: <path-name>                           # file: omitted -> this page itself
 ---
 ```
 
+**Write `file:` values version-relative so a page can be copied between `main` and `latest` with no front-matter edits:**
+
+- **Omit `file:`** when the source is the page that declares the test — it defaults to the declaring page.
+- **Use `${versionRoot}/...`** for prerequisites in the **same version** (e.g. `${versionRoot}/quickstart/install.md`). `${versionRoot}` expands to the version dir of the page declaring the test (`content/docs/kubernetes/main`, `.../latest`, etc.); `${version}` expands to just the segment (`main`/`latest`).
+- Use a **literal path** only when an entry must point at a *different* version on purpose.
+
+Token resolution covers the `kubernetes` and `standalone` sections; a `file:` that doesn't match the `content/docs/<section>/<version>/` layout is left as-is.
+
 **Pages with no testable content** (no code blocks, landing pages, concept pages, `_index.md` files without ordered steps, etc.) should be marked with `test: skip` instead of a scenario dict. This counts the page as covered in the test coverage report without generating any test cases:
 
 ```yaml
@@ -98,19 +107,19 @@ test: skip
 
 **Key principle:** The existing framework already supports every content type except pure link validation. Most "non-runnable" pages can become testable through content changes alone — adding hidden `{{< doc-test >}}` blocks that write configs, start services in the background, and run lightweight assertions. 
 
-Or for the latest (stable) version:
+Because the example above uses `${versionRoot}` and omits `file:` for the declaring page, the **same** front matter works under `latest/` without changes. Only when you deliberately mix versions do you write a literal path:
 
 ```yaml
 ---
 title: ...
 test:
   <scenario-name>:
-  - file: content/docs/standalone/latest/quickstart/<page>.md
+  - file: content/docs/standalone/latest/quickstart/<page>.md   # literal: pin a specific version
     path: <path-name>
 ---
 ```
 
-- Use the **content** path for `file`. List sources in dependency order if chaining (install → … → feature).
+- Prefer version-relative `file:` values (see above). List sources in dependency order if chaining (install → … → feature).
 - One scenario can list only the current page with one path if the guide is self-contained.
 - For Kubernetes docs, prerequisite files often come from `latest` (e.g. `content/docs/kubernetes/latest/quickstart/install.md`) while the feature page may be in `main` or `latest`.
 
@@ -299,7 +308,7 @@ When in doubt, flag the failure to the user rather than silently adjusting the t
 - [ ] If the guide has a long-running server, a **hidden** doc-test block starts it in the background (and optional trap/sleep); visible "start server" block has **no** path.
 - [ ] Placeholders in shell blocks are quoted or use `${VAR:-default}` so the script has no syntax errors.
 - [ ] `test:` front matter on the **content** page lists the right `file` and `path`; file path is the content path (extractor follows reuse). For pages with no testable content (index pages, no code blocks), use `test: skip` instead — counts toward coverage without generating test cases.
-- [ ] When copying a test chain between `main` and `latest`, **update every `file:` path** in front matter to match the target version directory.
+- [ ] `file:` values are **version-relative** (`${versionRoot}/...`, or omitted for the declaring page) so copying a page between `main` and `latest` needs **no** front-matter edits. Use a literal path only to point at a different version on purpose.
 - [ ] Prerequisite `file:` paths come from the guide's actual **Before you begin** links — don't guess; check the links to confirm exact paths.
 - [ ] No `kubectl port-forward` in any visible block — replace with YAMLTest HTTP assertions using `${INGRESS_GW_ADDRESS}`.
 - [ ] Host headers in YAMLTest `http.headers` use bare hostnames — no port suffix (e.g. `host: "example.com"`, not `host: "example.com:80"`). Including a port causes ECONNRESET, not an HTTP error.
diff --git a/.cursor/skills/doc-tests/SKILL.md b/.cursor/skills/doc-tests/SKILL.md
index 1ea2be88b..4d2573f0e 100644
--- a/.cursor/skills/doc-tests/SKILL.md
+++ b/.cursor/skills/doc-tests/SKILL.md
@@ -68,24 +68,19 @@ Use this skill when adding tests to documentation guides in the `website` repo s
 title: ...
 test:
   <scenario-name>:
-  - file: content/docs/standalone/main/quickstart/<page>.md
+  - file: ${versionRoot}/quickstart/<page>.md   # same-version prereq
     path: <path-name>
+  - path: <path-name>                           # file: omitted -> this page itself
 ---
 ```
 
-Or for the latest (stable) version:
+Write `file:` values **version-relative** so a page can be copied between `main` and `latest` with no front-matter edits:
 
-```yaml
----
-title: ...
-test:
-  <scenario-name>:
-  - file: content/docs/standalone/latest/quickstart/<page>.md
-    path: <path-name>
----
-```
+- **Omit `file:`** when the source is the page declaring the test (it defaults to that page).
+- **Use `${versionRoot}/...`** for same-version prerequisites. `${versionRoot}` expands to the version dir of the declaring page (`content/docs/kubernetes/main`, `.../latest`); `${version}` expands to just the segment. Covers the `kubernetes` and `standalone` sections.
+- Use a **literal path** only to point at a *different* version on purpose, e.g. `content/docs/standalone/latest/quickstart/<page>.md`.
 
-- Use the **content** path for `file`. List sources in dependency order if chaining (install → … → feature).
+- List sources in dependency order if chaining (install → … → feature).
 - One scenario can list only the current page with one path if the guide is self-contained.
 - For Kubernetes docs, prerequisite files often come from `latest` (e.g. `content/docs/kubernetes/latest/quickstart/install.md`) while the feature page may be in `main` or `latest`.
 
diff --git a/.github/workflows/doc-tests.yaml b/.github/workflows/doc-tests.yaml
index 9cabd07c5..d1f471742 100644
--- a/.github/workflows/doc-tests.yaml
+++ b/.github/workflows/doc-tests.yaml
@@ -89,7 +89,7 @@ jobs:
           else
             echo "has_tests=false" >> $GITHUB_OUTPUT
           fi
-          MATRIX=$(echo "$TESTS" | jq -c '(length | [., 20] | min) as $shards | . as $tests | {include: [range($shards) | . as $i | ([$tests | to_entries[] | select(.key % $shards == $i) | .value] as $shard | {shard_index: $i, test_count: ($shard | length), tests: ($shard | tojson), shard_name: ($shard | [.[].test] | join(", ") | if length > 80 then .[:77] + "..." else . end)})]}')
+          MATRIX=$(echo "$TESTS" | jq -c '(length | [., 40] | min) as $shards | . as $tests | {include: [range($shards) | . as $i | ([$tests | to_entries[] | select(.key % $shards == $i) | .value] as $shard | {shard_index: $i, test_count: ($shard | length), tests: ($shard | tojson), shard_name: ($shard | [.[].test] | join(", ") | if length > 80 then .[:77] + "..." else . end)})]}')
           echo "matrix=${MATRIX}" >> $GITHUB_OUTPUT
           echo "Discovered $COUNT test case(s)"
         env:
@@ -100,7 +100,7 @@ jobs:
     needs: discover
     if: needs.discover.outputs.has_tests == 'true'
     runs-on: ubuntu-latest
-    timeout-minutes: 30
+    timeout-minutes: 45
 
     strategy:
       matrix: ${{ fromJson(needs.discover.outputs.matrix) }}
diff --git a/assets/agw-docs/pages/operations/trace-requests-standalone.md b/assets/agw-docs/pages/operations/trace-requests-standalone.md
index 8422e8f71..034cb69d4 100644
--- a/assets/agw-docs/pages/operations/trace-requests-standalone.md
+++ b/assets/agw-docs/pages/operations/trace-requests-standalone.md
@@ -45,12 +45,8 @@ binds:
 ```
 
 {{< doc-test paths="trace-validate" >}}
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+# Install agentgateway binary
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 
 cat > /tmp/agctl-trace-config.yaml << 'EOF'
 binds:
diff --git a/assets/agw-docs/pages/operations/ui-standalone.md b/assets/agw-docs/pages/operations/ui-standalone.md
index a58aeb9b8..4b4252349 100644
--- a/assets/agw-docs/pages/operations/ui-standalone.md
+++ b/assets/agw-docs/pages/operations/ui-standalone.md
@@ -8,12 +8,7 @@ The Admin UI is separate from the [Web UI integrations]({{< link-hextra path="/i
 
 {{< doc-test paths="ui-standalone-default,ui-standalone-custom-port" >}}
 # Install agentgateway binary for tests
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 ## Open the Admin UI {#open-admin-ui}
diff --git a/assets/agw-docs/snippets/agentgateway/get-started.md b/assets/agw-docs/snippets/agentgateway/get-started.md
index a150d1920..9bc63e0f4 100644
--- a/assets/agw-docs/snippets/agentgateway/get-started.md
+++ b/assets/agw-docs/snippets/agentgateway/get-started.md
@@ -23,7 +23,7 @@
    ```sh {paths="standard"}
    helm upgrade -i {{< reuse "agw-docs/snippets/helm-kgateway-crds.md" >}} {{< reuse "agw-docs/snippets/helm-path-crds.md" >}} \
    --create-namespace --namespace {{< reuse "agw-docs/snippets/namespace.md" >}} \
-   --version v{{< reuse "agw-docs/versions/n-patch.md" >}} \
+   --version {{< reuse "agw-docs/versions/helm-version-flag.md" >}} \
    --set controller.image.pullPolicy=Always
    ```
    {{% /tab %}}
@@ -45,7 +45,7 @@
    ```sh {paths="standard"}
    helm upgrade -i {{< reuse "agw-docs/snippets/helm-kgateway.md" >}} {{< reuse "agw-docs/snippets/helm-path.md" >}} \
      --namespace {{< reuse "agw-docs/snippets/namespace.md" >}} \
-     --version v{{< reuse "agw-docs/versions/n-patch.md" >}} \
+     --version {{< reuse "agw-docs/versions/helm-version-flag.md" >}} \
      --set controller.image.pullPolicy=Always \
      --set controller.extraEnv.KGW_ENABLE_GATEWAY_API_EXPERIMENTAL_FEATURES=true \
      --wait
diff --git a/assets/agw-docs/snippets/install-agentgateway-binary.md b/assets/agw-docs/snippets/install-agentgateway-binary.md
index c66b29ca6..fadb78378 100644
--- a/assets/agw-docs/snippets/install-agentgateway-binary.md
+++ b/assets/agw-docs/snippets/install-agentgateway-binary.md
@@ -12,10 +12,11 @@ docker rm agw-extract
 chmod +x "$HOME/.local/bin/agentgateway"
 {{< /version >}}
 {{< version exclude-if="main" >}}
-# Install the latest released agentgateway binary to local bin without sudo.
+# Install the released agentgateway binary for this version to local bin without sudo.
 mkdir -p "$HOME/.local/bin"
 export PATH="$HOME/.local/bin:$PATH"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/latest/download/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
+VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
+BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
 curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
 chmod +x "$HOME/.local/bin/agentgateway"
 {{< /version >}}
diff --git a/assets/agw-docs/snippets/prereq-x-channel.md b/assets/agw-docs/snippets/prereq-x-channel.md
index 53cbc8f5c..35eae54bc 100644
--- a/assets/agw-docs/snippets/prereq-x-channel.md
+++ b/assets/agw-docs/snippets/prereq-x-channel.md
@@ -9,7 +9,7 @@
    ```sh
    helm upgrade -i {{< reuse "agw-docs/snippets/helm-kgateway.md" >}} {{< reuse "agw-docs/snippets/helm-path.md" >}}  \
      --namespace {{< reuse "agw-docs/snippets/namespace.md" >}} \
-     --version v{{< reuse "agw-docs/versions/n-patch.md" >}} \
+     --version {{< reuse "agw-docs/versions/helm-version-flag.md" >}} \
      --set controller.image.pullPolicy=Always \
      --set controller.extraEnv.KGW_ENABLE_GATEWAY_API_EXPERIMENTAL_FEATURES=true
    ```
diff --git a/assets/agw-docs/standalone/quickstart/llm.md b/assets/agw-docs/standalone/quickstart/llm.md
index cd8f615bf..6904f5c2f 100644
--- a/assets/agw-docs/standalone/quickstart/llm.md
+++ b/assets/agw-docs/standalone/quickstart/llm.md
@@ -61,13 +61,10 @@ To install the nightly build for development and testing:
    {{< /tabs >}}
 
 {{< doc-test paths="llm" >}}
-# For CI/tests: install dev version to local bin without sudo
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+# For CI/tests: install the agentgateway binary to local bin without sudo.
+# Uses the nightly 'latest-dev' image for main and the latest release otherwise,
+# so the version dir rotates without hardcoding a release tag that may not exist yet.
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 2. Get an [OpenAI API key](https://platform.openai.com/api-keys).
diff --git a/assets/agw-docs/standalone/quickstart/mcp.md b/assets/agw-docs/standalone/quickstart/mcp.md
index 8c7fe9a47..9a46e179e 100644
--- a/assets/agw-docs/standalone/quickstart/mcp.md
+++ b/assets/agw-docs/standalone/quickstart/mcp.md
@@ -4,12 +4,7 @@ Use the agentgateway binary to proxy requests to an open source MCP test server,
 
 {{< doc-test paths="mcp" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 1. [Install the agentgateway binary]({{< link-hextra path="/deployment/binary" >}}).
diff --git a/assets/agw-docs/standalone/quickstart/non-agentic-http.md b/assets/agw-docs/standalone/quickstart/non-agentic-http.md
index 856f4aa53..30f2dabf9 100644
--- a/assets/agw-docs/standalone/quickstart/non-agentic-http.md
+++ b/assets/agw-docs/standalone/quickstart/non-agentic-http.md
@@ -14,12 +14,7 @@ flowchart LR
 
 {{< doc-test paths="httpbin" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 1. [Install the agentgateway binary]({{< link-hextra path="/deployment/binary" >}}).
diff --git a/assets/agw-docs/standalone/virtual-keys.md b/assets/agw-docs/standalone/virtual-keys.md
index 26c2d0296..20253772d 100644
--- a/assets/agw-docs/standalone/virtual-keys.md
+++ b/assets/agw-docs/standalone/virtual-keys.md
@@ -31,12 +31,7 @@ flowchart TD
 
 {{< doc-test paths="virtual-keys" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 ## Set up virtual keys
diff --git a/assets/agw-docs/versions/helm-version-flag.md b/assets/agw-docs/versions/helm-version-flag.md
index bfbba6684..45586115d 100644
--- a/assets/agw-docs/versions/helm-version-flag.md
+++ b/assets/agw-docs/versions/helm-version-flag.md
@@ -1 +1 @@
-v{{< reuse "agw-docs/versions/n-patch.md" >}}
\ No newline at end of file
+{{< version exclude-if="main" >}}v{{< /version >}}{{< reuse "agw-docs/versions/n-patch.md" >}}
\ No newline at end of file
diff --git a/assets/agw-docs/versions/helm-version-upgrade.md b/assets/agw-docs/versions/helm-version-upgrade.md
index 955afe8e6..928b8652e 100644
--- a/assets/agw-docs/versions/helm-version-upgrade.md
+++ b/assets/agw-docs/versions/helm-version-upgrade.md
@@ -1 +1 @@
-v$NEW_VERSION
\ No newline at end of file
+{{< version exclude-if="main" >}}v{{< /version >}}$NEW_VERSION
\ No newline at end of file
diff --git a/content/docs/kubernetes/latest/agent/a2a.md b/content/docs/kubernetes/latest/agent/a2a.md
index d1189bff8..3e28d53d7 100644
--- a/content/docs/kubernetes/latest/agent/a2a.md
+++ b/content/docs/kubernetes/latest/agent/a2a.md
@@ -4,9 +4,9 @@ weight: 40
 description: Route to A2A servers and securely expose their skills through agentgateway.
 test:
   a2a:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/agent/a2a.md
+  - file: ${versionRoot}/agent/a2a.md
     path: a2a
 ---
 
diff --git a/content/docs/kubernetes/latest/install/helm.md b/content/docs/kubernetes/latest/install/helm.md
index 6ca05451b..3bb81a653 100644
--- a/content/docs/kubernetes/latest/install/helm.md
+++ b/content/docs/kubernetes/latest/install/helm.md
@@ -4,10 +4,10 @@ weight: 5
 description: Install agentgateway and related components.
 test:
   helm-install:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
   helm-install-experimental:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: experimental
 ---
 
diff --git a/content/docs/kubernetes/latest/install/sample-app.md b/content/docs/kubernetes/latest/install/sample-app.md
index 9c8f8968b..65d389677 100644
--- a/content/docs/kubernetes/latest/install/sample-app.md
+++ b/content/docs/kubernetes/latest/install/sample-app.md
@@ -4,11 +4,11 @@ weight: 20
 description: Set up the httpbin sample app to try traffic management, security, and resiliency guides.
 test:
   install-httpbin:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
 ---
 
diff --git a/content/docs/kubernetes/latest/integrations/llm-clients/_index.md b/content/docs/kubernetes/latest/integrations/llm-clients/_index.md
index 6e77c28b1..868ad2a32 100644
--- a/content/docs/kubernetes/latest/integrations/llm-clients/_index.md
+++ b/content/docs/kubernetes/latest/integrations/llm-clients/_index.md
@@ -4,11 +4,11 @@ weight: 10
 description: Configure AI coding tools and applications to use agentgateway running in Kubernetes
 test:
   llm-clients-k8s-gateway-url:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/integrations/llm-clients/_index.md
+  - file: ${versionRoot}/integrations/llm-clients/_index.md
     path: llm-clients-k8s-gateway-url
 ---
 
diff --git a/content/docs/kubernetes/latest/integrations/llm-clients/claude-code.md b/content/docs/kubernetes/latest/integrations/llm-clients/claude-code.md
index 3be3f93aa..75741877d 100644
--- a/content/docs/kubernetes/latest/integrations/llm-clients/claude-code.md
+++ b/content/docs/kubernetes/latest/integrations/llm-clients/claude-code.md
@@ -4,11 +4,11 @@ weight: 10
 description: Configure Claude Code CLI to use agentgateway running in Kubernetes
 test:
   claude-code-k8s:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/integrations/llm-clients/claude-code.md
+  - file: ${versionRoot}/integrations/llm-clients/claude-code.md
     path: claude-code-k8s
 ---
 
diff --git a/content/docs/kubernetes/latest/integrations/mcp-clients/_index.md b/content/docs/kubernetes/latest/integrations/mcp-clients/_index.md
index 2ee2fb99a..ecf563499 100644
--- a/content/docs/kubernetes/latest/integrations/mcp-clients/_index.md
+++ b/content/docs/kubernetes/latest/integrations/mcp-clients/_index.md
@@ -4,13 +4,13 @@ weight: 10
 description: Connect AI coding assistants to MCP servers exposed through agentgateway on Kubernetes
 test:
   mcp-clients-k8s:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/latest/integrations/mcp-clients/_index.md
+  - file: ${versionRoot}/integrations/mcp-clients/_index.md
     path: mcp-clients-k8s
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/budget-limits.md b/content/docs/kubernetes/latest/llm/budget-limits.md
index 588308801..0723e2ce8 100644
--- a/content/docs/kubernetes/latest/llm/budget-limits.md
+++ b/content/docs/kubernetes/latest/llm/budget-limits.md
@@ -4,13 +4,13 @@ weight: 75
 description: Control LLM spending by enforcing token budget limits per API key or user.
 test:
   budget-limits-apikey-auth:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/llm/budget-limits.md
+  - file: ${versionRoot}/llm/budget-limits.md
     path: budget-limits
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/content-routing.md b/content/docs/kubernetes/latest/llm/content-routing.md
index ca3d90e50..b1af23e00 100644
--- a/content/docs/kubernetes/latest/llm/content-routing.md
+++ b/content/docs/kubernetes/latest/llm/content-routing.md
@@ -4,11 +4,11 @@ weight: 45
 description: Route requests to different LLM backends based on request body content, such as the requested model name.
 test:
   content-routing-model:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/content-routing.md
+  - file: ${versionRoot}/llm/content-routing.md
     path: content-routing
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/failover.md b/content/docs/kubernetes/latest/llm/failover.md
index b8c6becca..590471af4 100644
--- a/content/docs/kubernetes/latest/llm/failover.md
+++ b/content/docs/kubernetes/latest/llm/failover.md
@@ -4,13 +4,13 @@ weight: 40
 description: Priority-based failover across LLM providers (automatic fallback when models fail or are rate-limited).
 test:
   failover:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/latest/llm/failover.md
+  - file: ${versionRoot}/llm/failover.md
     path: failover
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/load-balancing.md b/content/docs/kubernetes/latest/llm/load-balancing.md
index f31bb43f7..6fa2fa905 100644
--- a/content/docs/kubernetes/latest/llm/load-balancing.md
+++ b/content/docs/kubernetes/latest/llm/load-balancing.md
@@ -4,11 +4,11 @@ weight: 35
 description: Distribute requests across multiple LLM providers automatically (Power of Two Choices, P2C).
 test:
   load-balancing-multi-provider:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/load-balancing.md
+  - file: ${versionRoot}/llm/load-balancing.md
     path: load-balancing
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/observability.md b/content/docs/kubernetes/latest/llm/observability.md
index c539bd6e8..22c6550cd 100644
--- a/content/docs/kubernetes/latest/llm/observability.md
+++ b/content/docs/kubernetes/latest/llm/observability.md
@@ -4,13 +4,13 @@ weight: 95
 description: View LLM-specific metrics and access logs for token usage and request monitoring.
 test:
   llm-observability:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/llm/observability.md
+  - file: ${versionRoot}/llm/observability.md
     path: llm-observability
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/providers/httpbun.md b/content/docs/kubernetes/latest/llm/providers/httpbun.md
index 3b253d7b8..9b61950ef 100644
--- a/content/docs/kubernetes/latest/llm/providers/httpbun.md
+++ b/content/docs/kubernetes/latest/llm/providers/httpbun.md
@@ -4,11 +4,11 @@ weight: 100
 description: Set up httpbun as a mock OpenAI-compatible LLM backend for testing without API keys.
 test:
   setup-httpbun-llm:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/providers/ollama.md b/content/docs/kubernetes/latest/llm/providers/ollama.md
index ec566ba4a..26f036fe4 100644
--- a/content/docs/kubernetes/latest/llm/providers/ollama.md
+++ b/content/docs/kubernetes/latest/llm/providers/ollama.md
@@ -4,11 +4,11 @@ weight: 25
 description: Configure agentgateway to route LLM traffic to Ollama for local model inference
 test:
   ollama-provider-setup:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/ollama.md
+  - file: ${versionRoot}/llm/providers/ollama.md
     path: ollama-provider-setup
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/providers/openai.md b/content/docs/kubernetes/latest/llm/providers/openai.md
index d5dd322a2..ebbf3cd7f 100644
--- a/content/docs/kubernetes/latest/llm/providers/openai.md
+++ b/content/docs/kubernetes/latest/llm/providers/openai.md
@@ -4,11 +4,11 @@ weight: 20
 description: Configure OpenAI as an LLM provider for agentgateway.
 test:
   openai-setup:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/providers/vllm.md b/content/docs/kubernetes/latest/llm/providers/vllm.md
index 348910860..801145db1 100644
--- a/content/docs/kubernetes/latest/llm/providers/vllm.md
+++ b/content/docs/kubernetes/latest/llm/providers/vllm.md
@@ -4,11 +4,11 @@ weight: 30
 description: Configure agentgateway to route traffic to vLLM for self-hosted model inference
 test:
   vllm-provider-setup:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/vllm.md
+  - file: ${versionRoot}/llm/providers/vllm.md
     path: vllm-provider-setup
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/rate-limit.md b/content/docs/kubernetes/latest/llm/rate-limit.md
index bcaf43e16..226f03dc4 100644
--- a/content/docs/kubernetes/latest/llm/rate-limit.md
+++ b/content/docs/kubernetes/latest/llm/rate-limit.md
@@ -4,13 +4,13 @@ weight: 80
 description: Control LLM costs with token-based rate limiting and request-based limits.
 test:
   llm-token-rate-limit:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/latest/llm/rate-limit.md
+  - file: ${versionRoot}/llm/rate-limit.md
     path: llm-token-rate-limit
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/realtime.md b/content/docs/kubernetes/latest/llm/realtime.md
index 7f35fad4d..cc9d515d8 100644
--- a/content/docs/kubernetes/latest/llm/realtime.md
+++ b/content/docs/kubernetes/latest/llm/realtime.md
@@ -4,13 +4,13 @@ weight: 47
 description: Proxy OpenAI Realtime API WebSocket traffic and track token usage.
 test:
   realtime:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/llm/realtime.md
+  - file: ${versionRoot}/llm/realtime.md
     path: realtime
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/streaming.md b/content/docs/kubernetes/latest/llm/streaming.md
index a7744356b..6f867ddb9 100644
--- a/content/docs/kubernetes/latest/llm/streaming.md
+++ b/content/docs/kubernetes/latest/llm/streaming.md
@@ -4,13 +4,13 @@ weight: 45
 description: Stream responses from the LLM to the end user through agentgateway.
 test:
   streaming-openai:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/llm/streaming.md
+  - file: ${versionRoot}/llm/streaming.md
     path: streaming-openai
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/transformations.md b/content/docs/kubernetes/latest/llm/transformations.md
index 16a56754c..bcc3d14a4 100644
--- a/content/docs/kubernetes/latest/llm/transformations.md
+++ b/content/docs/kubernetes/latest/llm/transformations.md
@@ -4,22 +4,22 @@ weight: 70
 description: Dynamically compute and set LLM request fields using CEL expressions.
 test:
   llm-transformations:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/llm/transformations.md
+  - file: ${versionRoot}/llm/transformations.md
     path: llm-transformations
   llm-model-headers:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/llm/transformations.md
+  - file: ${versionRoot}/llm/transformations.md
     path: llm-model-headers
 ---
 
diff --git a/content/docs/kubernetes/latest/llm/virtual-keys.md b/content/docs/kubernetes/latest/llm/virtual-keys.md
index 4d9398fcc..b51791463 100644
--- a/content/docs/kubernetes/latest/llm/virtual-keys.md
+++ b/content/docs/kubernetes/latest/llm/virtual-keys.md
@@ -4,30 +4,30 @@ weight: 30
 description: Issue API keys with per-key token budgets and cost tracking (also known as virtual keys).
 test:
   virtual-keys-auth:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/latest/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys
-  - file: content/docs/kubernetes/latest/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys-httpbun-test
   virtual-keys-ratelimit:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/latest/security/rate-limit-global.md
+  - file: ${versionRoot}/security/rate-limit-global.md
     path: deploy-rate-limit-server
-  - file: content/docs/kubernetes/latest/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys
-  - file: content/docs/kubernetes/latest/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys-with-ratelimit
-  - file: content/docs/kubernetes/latest/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys-ratelimit-test
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/auth/keycloak.md b/content/docs/kubernetes/latest/mcp/auth/keycloak.md
index 968b8ff98..9c9cac448 100644
--- a/content/docs/kubernetes/latest/mcp/auth/keycloak.md
+++ b/content/docs/kubernetes/latest/mcp/auth/keycloak.md
@@ -4,9 +4,9 @@ weight: 20
 description: Deploy and configure Keycloak as an OAuth identity provider for MCP authentication with agentgateway.
 test:
   setup-keycloak:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: experimental
-  - file: content/docs/kubernetes/latest/mcp/auth/keycloak.md
+  - file: ${versionRoot}/mcp/auth/keycloak.md
     path: setup-keycloak
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/auth/setup.md b/content/docs/kubernetes/latest/mcp/auth/setup.md
index 91fc7ded1..953d46ba0 100644
--- a/content/docs/kubernetes/latest/mcp/auth/setup.md
+++ b/content/docs/kubernetes/latest/mcp/auth/setup.md
@@ -4,15 +4,15 @@ weight: 40
 description: Secure MCP servers with OAuth 2.0 authentication using agentgateway and an identity provider like Keycloak.
 test:
   mcp-auth-setup:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/latest/mcp/auth/keycloak.md
+  - file: ${versionRoot}/mcp/auth/keycloak.md
     path: setup-keycloak
-  - file: content/docs/kubernetes/latest/mcp/auth/setup.md
+  - file: ${versionRoot}/mcp/auth/setup.md
     path: mcp-auth-setup
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/dynamic-mcp.md b/content/docs/kubernetes/latest/mcp/dynamic-mcp.md
index c43d514ec..7b854148c 100644
--- a/content/docs/kubernetes/latest/mcp/dynamic-mcp.md
+++ b/content/docs/kubernetes/latest/mcp/dynamic-mcp.md
@@ -4,11 +4,11 @@ weight: 20
 description: Route traffic to MCP servers dynamically using label selectors so backends can be updated without changing the Backend resource.
 test:
   dynamic-mcp:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/dynamic-mcp.md
+  - file: ${versionRoot}/mcp/dynamic-mcp.md
     path: dynamic-mcp
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/guardrails/setup.md b/content/docs/kubernetes/latest/mcp/guardrails/setup.md
index 0b75efd81..c456b4626 100644
--- a/content/docs/kubernetes/latest/mcp/guardrails/setup.md
+++ b/content/docs/kubernetes/latest/mcp/guardrails/setup.md
@@ -4,11 +4,11 @@ weight: 20
 description: Gate and mutate MCP method calls with an external ExtMCP policy server.
 test:
   mcp-guardrails:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/guardrails/setup.md
+  - file: ${versionRoot}/mcp/guardrails/setup.md
     path: mcp-guardrails
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/rate-limit.md b/content/docs/kubernetes/latest/mcp/rate-limit.md
index fb7cb3b5d..6ac3de687 100644
--- a/content/docs/kubernetes/latest/mcp/rate-limit.md
+++ b/content/docs/kubernetes/latest/mcp/rate-limit.md
@@ -4,13 +4,13 @@ weight: 65
 description: Control MCP tool call rates to prevent overload and ensure fair access to expensive tools.
 test:
   mcp-local-rate-limit:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/latest/mcp/rate-limit.md
+  - file: ${versionRoot}/mcp/rate-limit.md
     path: mcp-local-rate-limit
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/static-mcp.md b/content/docs/kubernetes/latest/mcp/static-mcp.md
index ac99771e4..d90d28b2b 100644
--- a/content/docs/kubernetes/latest/mcp/static-mcp.md
+++ b/content/docs/kubernetes/latest/mcp/static-mcp.md
@@ -4,11 +4,11 @@ weight: 10
 description: Route traffic to an MCP server at a static address by configuring a fixed Backend resource.
 test:
   setup-mcp-server:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
 ---
 
diff --git a/content/docs/kubernetes/latest/mcp/virtual.md b/content/docs/kubernetes/latest/mcp/virtual.md
index 6ffe3266c..9d8b86b0c 100644
--- a/content/docs/kubernetes/latest/mcp/virtual.md
+++ b/content/docs/kubernetes/latest/mcp/virtual.md
@@ -4,11 +4,11 @@ weight: 30
 description: Federate tools from multiple MCP servers on a single gateway endpoint using virtual MCP multiplexing.
 test:
   virtual-mcp:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/mcp/virtual.md
+  - file: ${versionRoot}/mcp/virtual.md
     path: virtual-mcp
 ---
 
diff --git a/content/docs/kubernetes/latest/observability/control-plane-metrics.md b/content/docs/kubernetes/latest/observability/control-plane-metrics.md
index 88a4dbb67..aa20d5ce3 100644
--- a/content/docs/kubernetes/latest/observability/control-plane-metrics.md
+++ b/content/docs/kubernetes/latest/observability/control-plane-metrics.md
@@ -4,9 +4,9 @@ description: Monitor control plane health and performance with Prometheus metric
 weight: 20
 test:
   control-plane-metrics:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/observability/control-plane-metrics.md
+  - file: ${versionRoot}/observability/control-plane-metrics.md
     path: control-plane-metrics
 ---
 
diff --git a/content/docs/kubernetes/latest/observability/nacks.md b/content/docs/kubernetes/latest/observability/nacks.md
index 223479c6b..71b2bbe1d 100644
--- a/content/docs/kubernetes/latest/observability/nacks.md
+++ b/content/docs/kubernetes/latest/observability/nacks.md
@@ -4,11 +4,11 @@ description: Monitor and troubleshoot proxy configuration rejections with metric
 weight: 80
 test:
   nacks:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/observability/nacks.md
+  - file: ${versionRoot}/observability/nacks.md
     path: nacks
 ---
 
diff --git a/content/docs/kubernetes/latest/observability/otel-stack.md b/content/docs/kubernetes/latest/observability/otel-stack.md
index 3b6399118..76dace2ca 100644
--- a/content/docs/kubernetes/latest/observability/otel-stack.md
+++ b/content/docs/kubernetes/latest/observability/otel-stack.md
@@ -4,13 +4,13 @@ description: Install an OpenTelemetry stack with Grafana, Loki, and Tempo for ob
 weight: 10
 test:
   otel-stack:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/observability/otel-stack.md
+  - file: ${versionRoot}/observability/otel-stack.md
     path: otel-stack
 ---
 
diff --git a/content/docs/kubernetes/latest/observability/tracing.md b/content/docs/kubernetes/latest/observability/tracing.md
index 87645ddf9..4c4ebed23 100644
--- a/content/docs/kubernetes/latest/observability/tracing.md
+++ b/content/docs/kubernetes/latest/observability/tracing.md
@@ -4,13 +4,13 @@ description: Integrate with OpenTelemetry to collect and analyze request traces.
 weight: 90
 test:
   tracing:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/observability/tracing.md
+  - file: ${versionRoot}/observability/tracing.md
     path: tracing
 ---
 
diff --git a/content/docs/kubernetes/latest/observability/ui.md b/content/docs/kubernetes/latest/observability/ui.md
index 0316d2e3c..3acf4a7be 100644
--- a/content/docs/kubernetes/latest/observability/ui.md
+++ b/content/docs/kubernetes/latest/observability/ui.md
@@ -4,22 +4,22 @@ weight: 10
 description: Use the built-in Admin UI to inspect your Kubernetes agentgateway proxy configuration.
 test:
   admin-ui:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/observability/ui.md
+  - file: ${versionRoot}/observability/ui.md
     path: ui-k8s
   capture:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/quickstart/mcp.md
+  - file: ${versionRoot}/quickstart/mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/latest/quickstart/non-agentic-http.md
+  - file: ${versionRoot}/quickstart/non-agentic-http.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/observability/ui.md
+  - file: ${versionRoot}/observability/ui.md
     path: ui-k8s-capture
 ---
 
diff --git a/content/docs/kubernetes/latest/operations/uninstall.md b/content/docs/kubernetes/latest/operations/uninstall.md
index 327c75338..ecc115fc6 100644
--- a/content/docs/kubernetes/latest/operations/uninstall.md
+++ b/content/docs/kubernetes/latest/operations/uninstall.md
@@ -4,9 +4,9 @@ weight: 50
 description: Uninstall kgateway and related components.
 test:
   uninstall:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/operations/uninstall.md
+  - file: ${versionRoot}/operations/uninstall.md
     path: uninstall
 ---
 
diff --git a/content/docs/kubernetes/latest/operations/upgrade.md b/content/docs/kubernetes/latest/operations/upgrade.md
index 6912d7543..7b0b43b43 100644
--- a/content/docs/kubernetes/latest/operations/upgrade.md
+++ b/content/docs/kubernetes/latest/operations/upgrade.md
@@ -4,9 +4,9 @@ weight: 20
 description: Upgrade the control plane and any gateway proxies that run in your cluster.
 test:
   upgrade:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/operations/upgrade.md
+  - file: ${versionRoot}/operations/upgrade.md
     path: upgrade
 ---
 
diff --git a/content/docs/kubernetes/latest/quickstart/install.md b/content/docs/kubernetes/latest/quickstart/install.md
index fc307efa6..977b9f228 100644
--- a/content/docs/kubernetes/latest/quickstart/install.md
+++ b/content/docs/kubernetes/latest/quickstart/install.md
@@ -4,7 +4,7 @@ weight: 10
 description: Install the agentgateway control plane in your Kubernetes cluster.
 test:
   install:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
 ---
 
diff --git a/content/docs/kubernetes/latest/quickstart/llm.md b/content/docs/kubernetes/latest/quickstart/llm.md
index 24fc11e64..845dcd7f4 100644
--- a/content/docs/kubernetes/latest/quickstart/llm.md
+++ b/content/docs/kubernetes/latest/quickstart/llm.md
@@ -4,9 +4,9 @@ weight: 11
 description: Route requests to OpenAI's chat completions API with agentgateway on Kubernetes.
 test:
   openai:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/quickstart/llm.md
+  - file: ${versionRoot}/quickstart/llm.md
     path: openai-setup
 ---
 
diff --git a/content/docs/kubernetes/latest/quickstart/mcp.md b/content/docs/kubernetes/latest/quickstart/mcp.md
index 70aa97aab..56091c46c 100644
--- a/content/docs/kubernetes/latest/quickstart/mcp.md
+++ b/content/docs/kubernetes/latest/quickstart/mcp.md
@@ -4,9 +4,9 @@ weight: 12
 description: Connect to an MCP server and try tools with agentgateway on Kubernetes.
 test:
   mcp:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/quickstart/mcp.md
+  - file: ${versionRoot}/quickstart/mcp.md
     path: setup-mcp-server
 ---
 
diff --git a/content/docs/kubernetes/latest/quickstart/non-agentic-http.md b/content/docs/kubernetes/latest/quickstart/non-agentic-http.md
index e8af1d408..ebc90009c 100644
--- a/content/docs/kubernetes/latest/quickstart/non-agentic-http.md
+++ b/content/docs/kubernetes/latest/quickstart/non-agentic-http.md
@@ -4,9 +4,9 @@ weight: 13
 description: Route HTTP traffic to a backend such as httpbin with agentgateway on Kubernetes.
 test:
   httpbin:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/quickstart/non-agentic-http.md
+  - file: ${versionRoot}/quickstart/non-agentic-http.md
     path: install-httpbin
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/backend-health.md b/content/docs/kubernetes/latest/resiliency/backend-health.md
index 494e8fd33..cce65594b 100644
--- a/content/docs/kubernetes/latest/resiliency/backend-health.md
+++ b/content/docs/kubernetes/latest/resiliency/backend-health.md
@@ -4,13 +4,13 @@ weight: 15
 description: Automatically evict and restore unhealthy backend endpoints with passive health checking.
 test:
   backend-health:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/backend-health.md
+  - file: ${versionRoot}/resiliency/backend-health.md
     path: backend-health
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/connection.md b/content/docs/kubernetes/latest/resiliency/connection.md
index f3b25dedf..ad31f82bf 100644
--- a/content/docs/kubernetes/latest/resiliency/connection.md
+++ b/content/docs/kubernetes/latest/resiliency/connection.md
@@ -4,33 +4,33 @@ weight: 10
 description: Configure and manage HTTP connections to an upstream service.
 test:
   connection-general:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/connection.md
+  - file: ${versionRoot}/resiliency/connection.md
     path: connection-general
 
   connection-http1:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/connection.md
+  - file: ${versionRoot}/resiliency/connection.md
     path: connection-http1
 
   connection-http2-flow:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/connection.md
+  - file: ${versionRoot}/resiliency/connection.md
     path: connection-http2-flow
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/keepalive.md b/content/docs/kubernetes/latest/resiliency/keepalive.md
index 94b438a93..2a99f541d 100644
--- a/content/docs/kubernetes/latest/resiliency/keepalive.md
+++ b/content/docs/kubernetes/latest/resiliency/keepalive.md
@@ -4,23 +4,23 @@ weight: 10
 description: Manage idle and stale connections with TCP and HTTP keepalive.
 test:
   tcp-keepalive:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/keepalive.md
+  - file: ${versionRoot}/resiliency/keepalive.md
     path: tcp-keepalive
 
   http-keepalive:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/keepalive.md
+  - file: ${versionRoot}/resiliency/keepalive.md
     path: http-keepalive
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md b/content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md
index 9a007e2bf..42858e582 100644
--- a/content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md
+++ b/content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md
@@ -4,31 +4,31 @@ weight: 20
 description: Set up per-try timeouts.
 test:
   per-try-timeout-in-httproute:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md
+  - file: ${versionRoot}/resiliency/retry/per-try-timeout.md
     path: per-try-timeout-in-httproute
   per-try-timeout-in-agentgateway:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md
+  - file: ${versionRoot}/resiliency/retry/per-try-timeout.md
     path: per-try-timeout-in-agentgateway
   per-try-timeout-in-gatewaylistener:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/retry/per-try-timeout.md
+  - file: ${versionRoot}/resiliency/retry/per-try-timeout.md
     path: per-try-timeout-in-gatewaylistener
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/retry/retry.md b/content/docs/kubernetes/latest/resiliency/retry/retry.md
index 0b3e1280a..58b1633c9 100644
--- a/content/docs/kubernetes/latest/resiliency/retry/retry.md
+++ b/content/docs/kubernetes/latest/resiliency/retry/retry.md
@@ -4,31 +4,31 @@ weight: 10
 description: Set up retries for requests.
 test:
   retry-in-httproute:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/retry/retry.md
+  - file: ${versionRoot}/resiliency/retry/retry.md
     path: retry-in-httproute
   retry-in-agentgateway:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/retry/retry.md
+  - file: ${versionRoot}/resiliency/retry/retry.md
     path: retry-in-agentgateway
   retry-in-gatewaylistener:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/retry/retry.md
+  - file: ${versionRoot}/resiliency/retry/retry.md
     path: retry-in-gatewaylistener
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/timeouts/idle.md b/content/docs/kubernetes/latest/resiliency/timeouts/idle.md
index 29ce7e5de..ae8ba329b 100644
--- a/content/docs/kubernetes/latest/resiliency/timeouts/idle.md
+++ b/content/docs/kubernetes/latest/resiliency/timeouts/idle.md
@@ -4,13 +4,13 @@ weight: 20
 description: Set idle timeouts to terminate inactive HTTP/1 connections.
 test:
   idle-timeout:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/timeouts/idle.md
+  - file: ${versionRoot}/resiliency/timeouts/idle.md
     path: idle-timeout
 ---
 
diff --git a/content/docs/kubernetes/latest/resiliency/timeouts/request.md b/content/docs/kubernetes/latest/resiliency/timeouts/request.md
index 08c523be6..aa931ea42 100644
--- a/content/docs/kubernetes/latest/resiliency/timeouts/request.md
+++ b/content/docs/kubernetes/latest/resiliency/timeouts/request.md
@@ -4,31 +4,31 @@ weight: 10
 description: Configure timeouts for all routes in an HTTPRoute.
 test:
   timeout-in-httproute:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/timeouts/request.md
+  - file: ${versionRoot}/resiliency/timeouts/request.md
     path: timeout-in-httproute
   timeout-in-trafficpolicy:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/timeouts/request.md
+  - file: ${versionRoot}/resiliency/timeouts/request.md
     path: timeout-in-trafficpolicy
   timeout-in-gatewaylistener:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/resiliency/timeouts/request.md
+  - file: ${versionRoot}/resiliency/timeouts/request.md
     path: timeout-in-gatewaylistener
 ---
 
diff --git a/content/docs/kubernetes/latest/security/access-logging.md b/content/docs/kubernetes/latest/security/access-logging.md
index b0775f722..0a197bf8d 100644
--- a/content/docs/kubernetes/latest/security/access-logging.md
+++ b/content/docs/kubernetes/latest/security/access-logging.md
@@ -4,13 +4,13 @@ weight: 10
 description: Capture an access log for all the requests that enter the proxy.
 test:
   access-logging:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/security/access-logging.md
+  - file: ${versionRoot}/security/access-logging.md
     path: access-logging
 ---
 
diff --git a/content/docs/kubernetes/latest/security/cors.md b/content/docs/kubernetes/latest/security/cors.md
index d417b75e2..d2430a80e 100644
--- a/content/docs/kubernetes/latest/security/cors.md
+++ b/content/docs/kubernetes/latest/security/cors.md
@@ -4,23 +4,23 @@ description: Configure cross-origin resource sharing policies for cross-origin r
 weight: 10
 test:
   cors-in-httproute:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/security/cors.md
+  - file: ${versionRoot}/security/cors.md
     path: cors-in-httproute
 
   cors-in-agentgatewaypolicy:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/security/cors.md
+  - file: ${versionRoot}/security/cors.md
     path: cors-in-agentgatewaypolicy
 ---
 
diff --git a/content/docs/kubernetes/latest/security/csrf.md b/content/docs/kubernetes/latest/security/csrf.md
index 9566926c5..7c9b92a72 100644
--- a/content/docs/kubernetes/latest/security/csrf.md
+++ b/content/docs/kubernetes/latest/security/csrf.md
@@ -4,13 +4,13 @@ weight: 10
 description: Protect your applications from Cross-Site Request Forgery (CSRF) attacks.
 test:
   csrf:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/security/csrf.md
+  - file: ${versionRoot}/security/csrf.md
     path: csrf
 ---
 
diff --git a/content/docs/kubernetes/latest/security/rate-limit-global.md b/content/docs/kubernetes/latest/security/rate-limit-global.md
index 649bfe132..1af634236 100644
--- a/content/docs/kubernetes/latest/security/rate-limit-global.md
+++ b/content/docs/kubernetes/latest/security/rate-limit-global.md
@@ -4,13 +4,13 @@ weight: 45
 description: Apply distributed rate limits across multiple agentgateway replicas using an external rate limit service.
 test:
   global-rate-limit-by-ip:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/security/rate-limit-global.md
+  - file: ${versionRoot}/security/rate-limit-global.md
     path: global-rate-limit-by-ip
 ---
 
diff --git a/content/docs/kubernetes/latest/security/rate-limit-http.md b/content/docs/kubernetes/latest/security/rate-limit-http.md
index 67b9d7fca..e915c0db8 100644
--- a/content/docs/kubernetes/latest/security/rate-limit-http.md
+++ b/content/docs/kubernetes/latest/security/rate-limit-http.md
@@ -4,13 +4,13 @@ weight: 40
 description: Apply local and global rate limits to HTTP traffic to protect your backend services from overload.
 test:
   local-rate-limit:
-  - file: content/docs/kubernetes/latest/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/security/rate-limit-http.md
+  - file: ${versionRoot}/security/rate-limit-http.md
     path: local-rate-limit
 ---
 
diff --git a/content/docs/kubernetes/latest/setup/customize/customize.md b/content/docs/kubernetes/latest/setup/customize/customize.md
index 00f8f005b..13a104290 100644
--- a/content/docs/kubernetes/latest/setup/customize/customize.md
+++ b/content/docs/kubernetes/latest/setup/customize/customize.md
@@ -4,11 +4,11 @@ weight: 20
 description: Customize the agentgateway proxy for different deployment scenarios and requirements.
 test:
   customize:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/setup/customize/customize.md
+  - file: ${versionRoot}/setup/customize/customize.md
     path: customize
 ---
 
diff --git a/content/docs/kubernetes/latest/setup/gateway.md b/content/docs/kubernetes/latest/setup/gateway.md
index 6b1791bc2..e83e0dc40 100644
--- a/content/docs/kubernetes/latest/setup/gateway.md
+++ b/content/docs/kubernetes/latest/setup/gateway.md
@@ -4,9 +4,9 @@ weight: 10
 description: Set up an agentgateway proxy with Gateway API resources and custom configuration.
 test:
   setup-gateway:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
 ---
 
diff --git a/content/docs/kubernetes/latest/setup/listeners/http.md b/content/docs/kubernetes/latest/setup/listeners/http.md
index b4473dc98..41adf2959 100644
--- a/content/docs/kubernetes/latest/setup/listeners/http.md
+++ b/content/docs/kubernetes/latest/setup/listeners/http.md
@@ -4,13 +4,13 @@ weight: 10
 description: Create an HTTP listener on your gateway proxy to serve HTTPRoutes.
 test:
   http-listener:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/setup/listeners/http.md
+  - file: ${versionRoot}/setup/listeners/http.md
     path: http-listener
 ---
 
diff --git a/content/docs/kubernetes/latest/setup/listeners/https.md b/content/docs/kubernetes/latest/setup/listeners/https.md
index bd9907142..a1dc433c9 100644
--- a/content/docs/kubernetes/latest/setup/listeners/https.md
+++ b/content/docs/kubernetes/latest/setup/listeners/https.md
@@ -4,13 +4,13 @@ weight: 10
 description: Create an HTTPS listener on your gateway proxy to terminate TLS traffic.
 test:
   https-listener:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/setup/listeners/https.md
+  - file: ${versionRoot}/setup/listeners/https.md
     path: https-listener
 ---
 
diff --git a/content/docs/kubernetes/latest/setup/listeners/tls-settings.md b/content/docs/kubernetes/latest/setup/listeners/tls-settings.md
index 0e374af42..0ce68dfe0 100644
--- a/content/docs/kubernetes/latest/setup/listeners/tls-settings.md
+++ b/content/docs/kubernetes/latest/setup/listeners/tls-settings.md
@@ -4,11 +4,11 @@ description: Configure advanced TLS settings such as cipher suites and protocol
 weight: 20
 test:
   tls-settings:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/setup/listeners/tls-settings.md
+  - file: ${versionRoot}/setup/listeners/tls-settings.md
     path: tls-settings
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/buffering.md b/content/docs/kubernetes/latest/traffic-management/buffering.md
index 7d2de6923..469604ccd 100644
--- a/content/docs/kubernetes/latest/traffic-management/buffering.md
+++ b/content/docs/kubernetes/latest/traffic-management/buffering.md
@@ -4,11 +4,11 @@ weight: 10
 description: Buffer requests and responses for inspection or replay.
 test:
   buffering:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/buffering.md
+  - file: ${versionRoot}/traffic-management/buffering.md
     path: buffering
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/dfp.md b/content/docs/kubernetes/latest/traffic-management/dfp.md
index 3ce3a50f8..9b4378d1a 100644
--- a/content/docs/kubernetes/latest/traffic-management/dfp.md
+++ b/content/docs/kubernetes/latest/traffic-management/dfp.md
@@ -4,13 +4,13 @@ weight: 10
 description: Route traffic dynamically to upstream servers based on request characteristics.
 test:
   dfp:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/dfp.md
+  - file: ${versionRoot}/traffic-management/dfp.md
     path: dfp
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/direct-response.md b/content/docs/kubernetes/latest/traffic-management/direct-response.md
index 47030adeb..f9e608057 100644
--- a/content/docs/kubernetes/latest/traffic-management/direct-response.md
+++ b/content/docs/kubernetes/latest/traffic-management/direct-response.md
@@ -4,13 +4,13 @@ weight: 10
 description: Return responses directly without forwarding to upstream services.
 test:
   direct-response:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/direct-response.md
+  - file: ${versionRoot}/traffic-management/direct-response.md
     path: direct-response
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/extproc.md b/content/docs/kubernetes/latest/traffic-management/extproc.md
index e02c37242..c1473730c 100644
--- a/content/docs/kubernetes/latest/traffic-management/extproc.md
+++ b/content/docs/kubernetes/latest/traffic-management/extproc.md
@@ -4,13 +4,13 @@ weight: 10
 description: Modify requests and responses with an external gRPC processing server.
 test:
   extproc:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/extproc.md
+  - file: ${versionRoot}/traffic-management/extproc.md
     path: extproc
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/grpc.md b/content/docs/kubernetes/latest/traffic-management/grpc.md
index 3e77929de..c8c7acc3a 100644
--- a/content/docs/kubernetes/latest/traffic-management/grpc.md
+++ b/content/docs/kubernetes/latest/traffic-management/grpc.md
@@ -4,9 +4,9 @@ weight: 10
 description: Route and configure gRPC traffic in agentgateway.
 test:
   grpc:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/traffic-management/grpc.md
+  - file: ${versionRoot}/traffic-management/grpc.md
     path: grpc
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/header-control/early-request-header-modifier.md b/content/docs/kubernetes/latest/traffic-management/header-control/early-request-header-modifier.md
index d6787c18c..86d02c79b 100644
--- a/content/docs/kubernetes/latest/traffic-management/header-control/early-request-header-modifier.md
+++ b/content/docs/kubernetes/latest/traffic-management/header-control/early-request-header-modifier.md
@@ -4,13 +4,13 @@ weight: 30
 description: Modify request headers in the early phase of request processing.
 test:
   remove-reserved-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/early-request-header-modifier.md
+  - file: ${versionRoot}/traffic-management/header-control/early-request-header-modifier.md
     path: remove-reserved-header
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/header-control/request-header.md b/content/docs/kubernetes/latest/traffic-management/header-control/request-header.md
index 6d2b6f36b..6b0925cb2 100644
--- a/content/docs/kubernetes/latest/traffic-management/header-control/request-header.md
+++ b/content/docs/kubernetes/latest/traffic-management/header-control/request-header.md
@@ -4,31 +4,31 @@ weight: 10
 description: Add, set, or remove request headers.
 test:
   add-request-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/request-header.md
+  - file: ${versionRoot}/traffic-management/header-control/request-header.md
     path: add-request-header
   set-request-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/request-header.md
+  - file: ${versionRoot}/traffic-management/header-control/request-header.md
     path: set-request-header
   remove-request-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/request-header.md
+  - file: ${versionRoot}/traffic-management/header-control/request-header.md
     path: remove-request-header
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/header-control/response-header.md b/content/docs/kubernetes/latest/traffic-management/header-control/response-header.md
index 889528343..2d900c080 100644
--- a/content/docs/kubernetes/latest/traffic-management/header-control/response-header.md
+++ b/content/docs/kubernetes/latest/traffic-management/header-control/response-header.md
@@ -4,31 +4,31 @@ weight: 20
 description: Add, set, or remove response headers.
 test:
   add-response-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/response-header.md
+  - file: ${versionRoot}/traffic-management/header-control/response-header.md
     path: add-response-header
   set-response-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/response-header.md
+  - file: ${versionRoot}/traffic-management/header-control/response-header.md
     path: set-response-header
   remove-response-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/header-control/response-header.md
+  - file: ${versionRoot}/traffic-management/header-control/response-header.md
     path: remove-response-header
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/locality-aware-routing.md b/content/docs/kubernetes/latest/traffic-management/locality-aware-routing.md
index 45a5a802f..e3e3b454d 100644
--- a/content/docs/kubernetes/latest/traffic-management/locality-aware-routing.md
+++ b/content/docs/kubernetes/latest/traffic-management/locality-aware-routing.md
@@ -4,9 +4,9 @@ weight: 50
 description: Reduce cross-zone traffic costs and latency with topology-aware routing, and fail over to other localities when local endpoints are unavailable.
 test:
   locality-aware-routing:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/traffic-management/locality-aware-routing.md
+  - file: ${versionRoot}/traffic-management/locality-aware-routing.md
     path: locality-aware-routing
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/match/header.md b/content/docs/kubernetes/latest/traffic-management/match/header.md
index f5567b176..09fcaddda 100644
--- a/content/docs/kubernetes/latest/traffic-management/match/header.md
+++ b/content/docs/kubernetes/latest/traffic-management/match/header.md
@@ -4,22 +4,22 @@ weight: 10
 description: Match requests by header values using exact or regex patterns.
 test:
   header-match-exact:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/header.md
+  - file: ${versionRoot}/traffic-management/match/header.md
     path: header-match-exact
   header-match-regex:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/header.md
+  - file: ${versionRoot}/traffic-management/match/header.md
     path: header-match-regex
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/match/host.md b/content/docs/kubernetes/latest/traffic-management/match/host.md
index 2ac3a5be5..1b42c32ac 100644
--- a/content/docs/kubernetes/latest/traffic-management/match/host.md
+++ b/content/docs/kubernetes/latest/traffic-management/match/host.md
@@ -4,13 +4,13 @@ weight: 10
 description: Match requests by hostname.
 test:
   host-match:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/host.md
+  - file: ${versionRoot}/traffic-management/match/host.md
     path: host-match
 ---
 Expose a route on multiple hosts. 
diff --git a/content/docs/kubernetes/latest/traffic-management/match/method.md b/content/docs/kubernetes/latest/traffic-management/match/method.md
index 0d1bfc5a9..abc3ba1dd 100644
--- a/content/docs/kubernetes/latest/traffic-management/match/method.md
+++ b/content/docs/kubernetes/latest/traffic-management/match/method.md
@@ -4,13 +4,13 @@ weight: 10
 description: Match requests by HTTP method (GET, POST, PUT, PATCH, DELETE).
 test:
   method-match:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/method.md
+  - file: ${versionRoot}/traffic-management/match/method.md
     path: method-match
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/match/path.md b/content/docs/kubernetes/latest/traffic-management/match/path.md
index 76a67ecf1..183176e3b 100644
--- a/content/docs/kubernetes/latest/traffic-management/match/path.md
+++ b/content/docs/kubernetes/latest/traffic-management/match/path.md
@@ -4,31 +4,31 @@ weight: 10
 description: Match requests by path using exact, prefix, or regex patterns.
 test:
   path-match-exact:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/path.md
+  - file: ${versionRoot}/traffic-management/match/path.md
     path: path-match-exact
   path-match-prefix:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/path.md
+  - file: ${versionRoot}/traffic-management/match/path.md
     path: path-match-prefix
   path-match-regex:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/path.md
+  - file: ${versionRoot}/traffic-management/match/path.md
     path: path-match-regex
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/match/query.md b/content/docs/kubernetes/latest/traffic-management/match/query.md
index 9d9dc1040..1f4f84997 100644
--- a/content/docs/kubernetes/latest/traffic-management/match/query.md
+++ b/content/docs/kubernetes/latest/traffic-management/match/query.md
@@ -4,13 +4,13 @@ weight: 10
 description: Specify a set of URL query parameters which requests must match in entirety.
 test:
   query-match:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/match/query.md
+  - file: ${versionRoot}/traffic-management/match/query.md
     path: query-match
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/redirect/host.md b/content/docs/kubernetes/latest/traffic-management/redirect/host.md
index ea2309d91..d3a4242c2 100644
--- a/content/docs/kubernetes/latest/traffic-management/redirect/host.md
+++ b/content/docs/kubernetes/latest/traffic-management/redirect/host.md
@@ -4,13 +4,13 @@ weight: 442
 description: Redirect requests to a different host.
 test:
   host-redirect:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/redirect/host.md
+  - file: ${versionRoot}/traffic-management/redirect/host.md
     path: host-redirect
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/redirect/https.md b/content/docs/kubernetes/latest/traffic-management/redirect/https.md
index ce1dfab16..7e2186870 100644
--- a/content/docs/kubernetes/latest/traffic-management/redirect/https.md
+++ b/content/docs/kubernetes/latest/traffic-management/redirect/https.md
@@ -4,13 +4,13 @@ weight: 441
 description: Redirect HTTP traffic to HTTPS.
 test:
   https-redirect:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/redirect/https.md
+  - file: ${versionRoot}/traffic-management/redirect/https.md
     path: https-redirect
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/redirect/path.md b/content/docs/kubernetes/latest/traffic-management/redirect/path.md
index 3183f261e..b87e9cd2f 100644
--- a/content/docs/kubernetes/latest/traffic-management/redirect/path.md
+++ b/content/docs/kubernetes/latest/traffic-management/redirect/path.md
@@ -4,22 +4,22 @@ weight: 443
 description: Redirect requests to a different path prefix.
 test:
   path-redirect-prefix:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/redirect/path.md
+  - file: ${versionRoot}/traffic-management/redirect/path.md
     path: path-redirect-prefix
   path-redirect-full:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/redirect/path.md
+  - file: ${versionRoot}/traffic-management/redirect/path.md
     path: path-redirect-full
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/rewrite/host.md b/content/docs/kubernetes/latest/traffic-management/rewrite/host.md
index 6ecaa4dd0..010b23735 100644
--- a/content/docs/kubernetes/latest/traffic-management/rewrite/host.md
+++ b/content/docs/kubernetes/latest/traffic-management/rewrite/host.md
@@ -4,13 +4,13 @@ weight: 461
 description: Replace the host header value before forwarding a request to a backend service.
 test:
   host-rewrite:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/rewrite/host.md
+  - file: ${versionRoot}/traffic-management/rewrite/host.md
     path: host-rewrite
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/rewrite/path.md b/content/docs/kubernetes/latest/traffic-management/rewrite/path.md
index d7d922b92..019c849be 100644
--- a/content/docs/kubernetes/latest/traffic-management/rewrite/path.md
+++ b/content/docs/kubernetes/latest/traffic-management/rewrite/path.md
@@ -4,22 +4,22 @@ weight: 462
 description: Rewrite path prefixes in requests.
 test:
   path-rewrite-prefix:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/rewrite/path.md
+  - file: ${versionRoot}/traffic-management/rewrite/path.md
     path: path-rewrite-prefix
   path-rewrite-full:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/rewrite/path.md
+  - file: ${versionRoot}/traffic-management/rewrite/path.md
     path: path-rewrite-full
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/route-delegation/basic.md b/content/docs/kubernetes/latest/traffic-management/route-delegation/basic.md
index 55837179f..938875b8e 100644
--- a/content/docs/kubernetes/latest/traffic-management/route-delegation/basic.md
+++ b/content/docs/kubernetes/latest/traffic-management/route-delegation/basic.md
@@ -4,13 +4,13 @@ weight: 10
 description: Set up basic route delegation between a parent HTTPRoute and two child HTTPRoutes.
 test:
   basic:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/basic.md
+  - file: ${versionRoot}/traffic-management/route-delegation/basic.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/basic.md
+  - file: ${versionRoot}/traffic-management/route-delegation/basic.md
     path: basic
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/route-delegation/header-query.md b/content/docs/kubernetes/latest/traffic-management/route-delegation/header-query.md
index 3c5cd3b91..8a4de6f96 100644
--- a/content/docs/kubernetes/latest/traffic-management/route-delegation/header-query.md
+++ b/content/docs/kubernetes/latest/traffic-management/route-delegation/header-query.md
@@ -4,13 +4,13 @@ weight: 40
 description: Use header and query matchers in a route delegation setup.
 test:
   header-query:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/header-query.md
+  - file: ${versionRoot}/traffic-management/route-delegation/header-query.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/header-query.md
+  - file: ${versionRoot}/traffic-management/route-delegation/header-query.md
     path: header-query
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/native-policies.md b/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/native-policies.md
index ec4ac4e7e..5dce7ba2e 100644
--- a/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/native-policies.md
+++ b/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/native-policies.md
@@ -4,13 +4,13 @@ weight: 10
 description: Learn how Kubernetes Gateway API policies, such as request timeouts, are inherited and overridden along the route delegation chain.
 test:
   native-policies:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/native-policies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/native-policies.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/native-policies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/native-policies.md
     path: native-policies
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/trafficpolicies.md b/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/trafficpolicies.md
index d56175c90..8d0781eab 100644
--- a/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/trafficpolicies.md
+++ b/content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/trafficpolicies.md
@@ -4,13 +4,13 @@ weight: 20
 description: Learn how policies in `AgentgatewayPolicy` resources are inherited and overridden along the route delegation chain.
 test:
   trafficpolicies:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/trafficpolicies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/trafficpolicies.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/inheritance/trafficpolicies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/trafficpolicies.md
     path: trafficpolicies
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/route-delegation/label.md b/content/docs/kubernetes/latest/traffic-management/route-delegation/label.md
index 6659cc796..7926cca1e 100644
--- a/content/docs/kubernetes/latest/traffic-management/route-delegation/label.md
+++ b/content/docs/kubernetes/latest/traffic-management/route-delegation/label.md
@@ -4,13 +4,13 @@ weight: 20
 description: Use labels to delegate traffic to child HTTPRoutes with the `<key>=<value>` syntax.
 test:
   label:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/label.md
+  - file: ${versionRoot}/traffic-management/route-delegation/label.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/label.md
+  - file: ${versionRoot}/traffic-management/route-delegation/label.md
     path: label
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/route-delegation/multi-level-delegation.md b/content/docs/kubernetes/latest/traffic-management/route-delegation/multi-level-delegation.md
index dc9138f18..56e225bcd 100644
--- a/content/docs/kubernetes/latest/traffic-management/route-delegation/multi-level-delegation.md
+++ b/content/docs/kubernetes/latest/traffic-management/route-delegation/multi-level-delegation.md
@@ -4,13 +4,13 @@ weight: 30
 description: Create a 3-level route delegation hierarchy with a parent, child, and grandchild HTTPRoute.
 test:
   multi-level:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/multi-level-delegation.md
+  - file: ${versionRoot}/traffic-management/route-delegation/multi-level-delegation.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/latest/traffic-management/route-delegation/multi-level-delegation.md
+  - file: ${versionRoot}/traffic-management/route-delegation/multi-level-delegation.md
     path: multi-level
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/traffic-split.md b/content/docs/kubernetes/latest/traffic-management/traffic-split.md
index de262b986..14c9f7c52 100644
--- a/content/docs/kubernetes/latest/traffic-management/traffic-split.md
+++ b/content/docs/kubernetes/latest/traffic-management/traffic-split.md
@@ -4,13 +4,13 @@ weight: 60
 description: Set up A/B testing, traffic splitting, and canary deployments using weighted routing.
 test:
   traffic-split-llm-models:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/traffic-management/traffic-split.md
+  - file: ${versionRoot}/traffic-management/traffic-split.md
     path: traffic-split-llm
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/access-logs.md b/content/docs/kubernetes/latest/traffic-management/transformations/access-logs.md
index 017c60244..355c4202c 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/access-logs.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/access-logs.md
@@ -4,22 +4,22 @@ weight: 120
 description: Log CEL context variables to access logs to inspect and debug transformation expressions at runtime.
 test:
   access-logs:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/access-logs.md
+  - file: ${versionRoot}/traffic-management/transformations/access-logs.md
     path: access-logs
   access-logs-filter:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/access-logs.md
+  - file: ${versionRoot}/traffic-management/transformations/access-logs.md
     path: access-logs-filter
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/encode.md b/content/docs/kubernetes/latest/traffic-management/transformations/encode.md
index 99868294e..a60518f3c 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/encode.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/encode.md
@@ -4,22 +4,22 @@ weight: 20
 description: Automatically encode and decode base64 values in request headers.
 test:
   encode:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/encode.md
+  - file: ${versionRoot}/traffic-management/transformations/encode.md
     path: encode
   decode:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/encode.md
+  - file: ${versionRoot}/traffic-management/transformations/encode.md
     path: decode
 ---
 {{< reuse "agw-docs/pages/traffic-management/transformations/encode.md" >}}
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/filter-request-body.md b/content/docs/kubernetes/latest/traffic-management/transformations/filter-request-body.md
index d08f8ac0f..ec5ac6866 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/filter-request-body.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/filter-request-body.md
@@ -4,13 +4,13 @@ weight: 60
 description: Use filterKeys() and merge() CEL functions to strip unwanted fields from a JSON request body and inject defaults before forwarding to the upstream.
 test:
   filter-request-body:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/filter-request-body.md
+  - file: ${versionRoot}/traffic-management/transformations/filter-request-body.md
     path: filter-request-body
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/forward.md b/content/docs/kubernetes/latest/traffic-management/transformations/forward.md
index e900189c4..a7dd77c7d 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/forward.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/forward.md
@@ -4,13 +4,13 @@ weight: 40
 description: Use CEL expressions to construct a full request URL from context variables and forward it upstream as a request header.
 test:
   forward:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/forward.md
+  - file: ${versionRoot}/traffic-management/transformations/forward.md
     path: forward
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-body.md b/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-body.md
index 4207b5ac7..f5d8002e9 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-body.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-body.md
@@ -4,22 +4,22 @@ weight: 55
 description: Learn how to return a customized response body and how to replace specific values in the body.
 test:
   inject-header-into-body:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/inject-response-body.md
+  - file: ${versionRoot}/traffic-management/transformations/inject-response-body.md
     path: inject-header-into-body
   inject-body-field-into-body:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/inject-response-body.md
+  - file: ${versionRoot}/traffic-management/transformations/inject-response-body.md
     path: inject-body-field-into-body
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-headers.md b/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-headers.md
index c92d0efda..a69d3f775 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-headers.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/inject-response-headers.md
@@ -4,13 +4,13 @@ weight: 5
 description: Extract values from a request header and inject it as a header to your response.
 test:
   inject-response-headers:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/inject-response-headers.md
+  - file: ${versionRoot}/traffic-management/transformations/inject-response-headers.md
     path: inject-response-headers
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/llm-model-headers.md b/content/docs/kubernetes/latest/traffic-management/transformations/llm-model-headers.md
index 2594655d1..c6eb9f8cb 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/llm-model-headers.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/llm-model-headers.md
@@ -4,25 +4,24 @@ weight: 47
 description: Detect model fallback by injecting the requested and actual LLM model names as response headers using llm.requestModel and llm.responseModel CEL variables.
 test:
   llm-transformations:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/llm-model-headers.md
+  - file: ${versionRoot}/traffic-management/transformations/llm-model-headers.md
     path: llm-transformations
 
   llm-model-headers:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/llm-model-headers.md
+  - file: ${versionRoot}/traffic-management/transformations/llm-model-headers.md
     path: llm-model-headers
-
 ---
 
 {{< reuse "agw-docs/pages/agentgateway/llm/transformations.md" >}}
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/path-method.md b/content/docs/kubernetes/latest/traffic-management/transformations/path-method.md
index 0babe1fa2..ef2b7afd6 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/path-method.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/path-method.md
@@ -4,13 +4,13 @@ weight: 45
 description: Use pseudo headers to conditionally rewrite the request path and HTTP method based on a request header value.
 test:
   path-method:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/path-method.md
+  - file: ${versionRoot}/traffic-management/transformations/path-method.md
     path: path-method
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/query.md b/content/docs/kubernetes/latest/traffic-management/transformations/query.md
index 622d1abdb..29e47d76a 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/query.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/query.md
@@ -4,13 +4,13 @@ weight: 46
 description: Read a query parameter from the request URI and inject it as a request header using a CEL conditional expression.
 test:
   query:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/query.md
+  - file: ${versionRoot}/traffic-management/transformations/query.md
     path: query
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/remove-header.md b/content/docs/kubernetes/latest/traffic-management/transformations/remove-header.md
index 78cd0b123..cbfabc497 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/remove-header.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/remove-header.md
@@ -4,13 +4,13 @@ weight: 50
 description: Remove sensitive or internal headers from requests before they reach the upstream.
 test:
   remove-header:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/remove-header.md
+  - file: ${versionRoot}/traffic-management/transformations/remove-header.md
     path: remove-header
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/rewrite.md b/content/docs/kubernetes/latest/traffic-management/transformations/rewrite.md
index 3fd58189f..5832f15ca 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/rewrite.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/rewrite.md
@@ -4,13 +4,13 @@ weight: 30
 description: Use CEL functions to rewrite request paths in a header.
 test:
   rewrite:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/rewrite.md
+  - file: ${versionRoot}/traffic-management/transformations/rewrite.md
     path: rewrite
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/status.md b/content/docs/kubernetes/latest/traffic-management/transformations/status.md
index 79b331593..6f47d560e 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/status.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/status.md
@@ -4,13 +4,13 @@ weight: 60
 description: Update the response status based on the headers in a response.
 test:
   change-response-status:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/status.md
+  - file: ${versionRoot}/traffic-management/transformations/status.md
     path: change-response-status
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/tracing.md b/content/docs/kubernetes/latest/traffic-management/transformations/tracing.md
index 5aa55025b..044e1405d 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/tracing.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/tracing.md
@@ -4,13 +4,13 @@ weight: 10
 description: Use uuid() and random() CEL functions to inject a unique request ID and a random sampling value into request headers.
 test:
   tracing:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/tracing.md
+  - file: ${versionRoot}/traffic-management/transformations/tracing.md
     path: tracing
 ---
 
diff --git a/content/docs/kubernetes/latest/traffic-management/transformations/validate.md b/content/docs/kubernetes/latest/traffic-management/transformations/validate.md
index ba7d9d112..313066d79 100644
--- a/content/docs/kubernetes/latest/traffic-management/transformations/validate.md
+++ b/content/docs/kubernetes/latest/traffic-management/transformations/validate.md
@@ -4,22 +4,22 @@ weight: 70
 description: Use default() and fail() CEL functions to enforce required fields and apply default values on a JSON request body.
 test:
   validate-defaults:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/validate.md
+  - file: ${versionRoot}/traffic-management/transformations/validate.md
     path: validate-defaults
   validate-skip:
-  - file: content/docs/kubernetes/latest/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/latest/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/latest/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/latest/traffic-management/transformations/validate.md
+  - file: ${versionRoot}/traffic-management/transformations/validate.md
     path: validate-skip
 ---
 
diff --git a/content/docs/kubernetes/main/agent/a2a.md b/content/docs/kubernetes/main/agent/a2a.md
index 886d102b2..3e28d53d7 100644
--- a/content/docs/kubernetes/main/agent/a2a.md
+++ b/content/docs/kubernetes/main/agent/a2a.md
@@ -4,9 +4,9 @@ weight: 40
 description: Route to A2A servers and securely expose their skills through agentgateway.
 test:
   a2a:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/agent/a2a.md
+  - file: ${versionRoot}/agent/a2a.md
     path: a2a
 ---
 
diff --git a/content/docs/kubernetes/main/install/helm.md b/content/docs/kubernetes/main/install/helm.md
index eba9b0e0f..3bb81a653 100644
--- a/content/docs/kubernetes/main/install/helm.md
+++ b/content/docs/kubernetes/main/install/helm.md
@@ -4,10 +4,10 @@ weight: 5
 description: Install agentgateway and related components.
 test:
   helm-install:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
   helm-install-experimental:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: experimental
 ---
 
diff --git a/content/docs/kubernetes/main/install/sample-app.md b/content/docs/kubernetes/main/install/sample-app.md
index 6d8a43014..65d389677 100644
--- a/content/docs/kubernetes/main/install/sample-app.md
+++ b/content/docs/kubernetes/main/install/sample-app.md
@@ -4,11 +4,11 @@ weight: 20
 description: Set up the httpbin sample app to try traffic management, security, and resiliency guides.
 test:
   install-httpbin:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
 ---
 
diff --git a/content/docs/kubernetes/main/integrations/llm-clients/_index.md b/content/docs/kubernetes/main/integrations/llm-clients/_index.md
index e09d9cea0..868ad2a32 100644
--- a/content/docs/kubernetes/main/integrations/llm-clients/_index.md
+++ b/content/docs/kubernetes/main/integrations/llm-clients/_index.md
@@ -4,11 +4,11 @@ weight: 10
 description: Configure AI coding tools and applications to use agentgateway running in Kubernetes
 test:
   llm-clients-k8s-gateway-url:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/integrations/llm-clients/_index.md
+  - file: ${versionRoot}/integrations/llm-clients/_index.md
     path: llm-clients-k8s-gateway-url
 ---
 
diff --git a/content/docs/kubernetes/main/integrations/llm-clients/claude-code.md b/content/docs/kubernetes/main/integrations/llm-clients/claude-code.md
index d336fc695..75741877d 100644
--- a/content/docs/kubernetes/main/integrations/llm-clients/claude-code.md
+++ b/content/docs/kubernetes/main/integrations/llm-clients/claude-code.md
@@ -4,11 +4,11 @@ weight: 10
 description: Configure Claude Code CLI to use agentgateway running in Kubernetes
 test:
   claude-code-k8s:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/integrations/llm-clients/claude-code.md
+  - file: ${versionRoot}/integrations/llm-clients/claude-code.md
     path: claude-code-k8s
 ---
 
diff --git a/content/docs/kubernetes/main/integrations/mcp-clients/_index.md b/content/docs/kubernetes/main/integrations/mcp-clients/_index.md
index 69b309e43..ecf563499 100644
--- a/content/docs/kubernetes/main/integrations/mcp-clients/_index.md
+++ b/content/docs/kubernetes/main/integrations/mcp-clients/_index.md
@@ -4,13 +4,13 @@ weight: 10
 description: Connect AI coding assistants to MCP servers exposed through agentgateway on Kubernetes
 test:
   mcp-clients-k8s:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/main/integrations/mcp-clients/_index.md
+  - file: ${versionRoot}/integrations/mcp-clients/_index.md
     path: mcp-clients-k8s
 ---
 
diff --git a/content/docs/kubernetes/main/llm/budget-limits.md b/content/docs/kubernetes/main/llm/budget-limits.md
index d3a3b9952..0723e2ce8 100644
--- a/content/docs/kubernetes/main/llm/budget-limits.md
+++ b/content/docs/kubernetes/main/llm/budget-limits.md
@@ -4,13 +4,13 @@ weight: 75
 description: Control LLM spending by enforcing token budget limits per API key or user.
 test:
   budget-limits-apikey-auth:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/llm/budget-limits.md
+  - file: ${versionRoot}/llm/budget-limits.md
     path: budget-limits
 ---
 
diff --git a/content/docs/kubernetes/main/llm/content-routing.md b/content/docs/kubernetes/main/llm/content-routing.md
index 082e1e535..b1af23e00 100644
--- a/content/docs/kubernetes/main/llm/content-routing.md
+++ b/content/docs/kubernetes/main/llm/content-routing.md
@@ -4,11 +4,11 @@ weight: 45
 description: Route requests to different LLM backends based on request body content, such as the requested model name.
 test:
   content-routing-model:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/content-routing.md
+  - file: ${versionRoot}/llm/content-routing.md
     path: content-routing
 ---
 
diff --git a/content/docs/kubernetes/main/llm/failover.md b/content/docs/kubernetes/main/llm/failover.md
index f040d32eb..590471af4 100644
--- a/content/docs/kubernetes/main/llm/failover.md
+++ b/content/docs/kubernetes/main/llm/failover.md
@@ -4,13 +4,13 @@ weight: 40
 description: Priority-based failover across LLM providers (automatic fallback when models fail or are rate-limited).
 test:
   failover:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/main/llm/failover.md
+  - file: ${versionRoot}/llm/failover.md
     path: failover
 ---
 
diff --git a/content/docs/kubernetes/main/llm/load-balancing.md b/content/docs/kubernetes/main/llm/load-balancing.md
index 57b41c20d..6fa2fa905 100644
--- a/content/docs/kubernetes/main/llm/load-balancing.md
+++ b/content/docs/kubernetes/main/llm/load-balancing.md
@@ -4,11 +4,11 @@ weight: 35
 description: Distribute requests across multiple LLM providers automatically (Power of Two Choices, P2C).
 test:
   load-balancing-multi-provider:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/load-balancing.md
+  - file: ${versionRoot}/llm/load-balancing.md
     path: load-balancing
 ---
 
diff --git a/content/docs/kubernetes/main/llm/observability.md b/content/docs/kubernetes/main/llm/observability.md
index 3e033dde4..22c6550cd 100644
--- a/content/docs/kubernetes/main/llm/observability.md
+++ b/content/docs/kubernetes/main/llm/observability.md
@@ -4,13 +4,13 @@ weight: 95
 description: View LLM-specific metrics and access logs for token usage and request monitoring.
 test:
   llm-observability:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/llm/observability.md
+  - file: ${versionRoot}/llm/observability.md
     path: llm-observability
 ---
 
diff --git a/content/docs/kubernetes/main/llm/providers/httpbun.md b/content/docs/kubernetes/main/llm/providers/httpbun.md
index a1c91bc8f..9b61950ef 100644
--- a/content/docs/kubernetes/main/llm/providers/httpbun.md
+++ b/content/docs/kubernetes/main/llm/providers/httpbun.md
@@ -4,11 +4,11 @@ weight: 100
 description: Set up httpbun as a mock OpenAI-compatible LLM backend for testing without API keys.
 test:
   setup-httpbun-llm:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
 ---
 
diff --git a/content/docs/kubernetes/main/llm/providers/ollama.md b/content/docs/kubernetes/main/llm/providers/ollama.md
index 912b03529..26f036fe4 100644
--- a/content/docs/kubernetes/main/llm/providers/ollama.md
+++ b/content/docs/kubernetes/main/llm/providers/ollama.md
@@ -4,11 +4,11 @@ weight: 25
 description: Configure agentgateway to route LLM traffic to Ollama for local model inference
 test:
   ollama-provider-setup:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/ollama.md
+  - file: ${versionRoot}/llm/providers/ollama.md
     path: ollama-provider-setup
 ---
 
diff --git a/content/docs/kubernetes/main/llm/providers/openai.md b/content/docs/kubernetes/main/llm/providers/openai.md
index a8b7b0a6f..ebbf3cd7f 100644
--- a/content/docs/kubernetes/main/llm/providers/openai.md
+++ b/content/docs/kubernetes/main/llm/providers/openai.md
@@ -4,11 +4,11 @@ weight: 20
 description: Configure OpenAI as an LLM provider for agentgateway.
 test:
   openai-setup:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
 ---
 
diff --git a/content/docs/kubernetes/main/llm/providers/vllm.md b/content/docs/kubernetes/main/llm/providers/vllm.md
index 639b7829e..801145db1 100644
--- a/content/docs/kubernetes/main/llm/providers/vllm.md
+++ b/content/docs/kubernetes/main/llm/providers/vllm.md
@@ -4,11 +4,11 @@ weight: 30
 description: Configure agentgateway to route traffic to vLLM for self-hosted model inference
 test:
   vllm-provider-setup:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/vllm.md
+  - file: ${versionRoot}/llm/providers/vllm.md
     path: vllm-provider-setup
 ---
 
diff --git a/content/docs/kubernetes/main/llm/rate-limit.md b/content/docs/kubernetes/main/llm/rate-limit.md
index 9cec281ff..226f03dc4 100644
--- a/content/docs/kubernetes/main/llm/rate-limit.md
+++ b/content/docs/kubernetes/main/llm/rate-limit.md
@@ -4,13 +4,13 @@ weight: 80
 description: Control LLM costs with token-based rate limiting and request-based limits.
 test:
   llm-token-rate-limit:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/main/llm/rate-limit.md
+  - file: ${versionRoot}/llm/rate-limit.md
     path: llm-token-rate-limit
 ---
 
diff --git a/content/docs/kubernetes/main/llm/realtime.md b/content/docs/kubernetes/main/llm/realtime.md
index 8aaa9e6ee..cc9d515d8 100644
--- a/content/docs/kubernetes/main/llm/realtime.md
+++ b/content/docs/kubernetes/main/llm/realtime.md
@@ -4,13 +4,13 @@ weight: 47
 description: Proxy OpenAI Realtime API WebSocket traffic and track token usage.
 test:
   realtime:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/llm/realtime.md
+  - file: ${versionRoot}/llm/realtime.md
     path: realtime
 ---
 
diff --git a/content/docs/kubernetes/main/llm/streaming.md b/content/docs/kubernetes/main/llm/streaming.md
index 13b8a3836..6f867ddb9 100644
--- a/content/docs/kubernetes/main/llm/streaming.md
+++ b/content/docs/kubernetes/main/llm/streaming.md
@@ -4,13 +4,13 @@ weight: 45
 description: Stream responses from the LLM to the end user through agentgateway.
 test:
   streaming-openai:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/llm/streaming.md
+  - file: ${versionRoot}/llm/streaming.md
     path: streaming-openai
 ---
 
diff --git a/content/docs/kubernetes/main/llm/transformations.md b/content/docs/kubernetes/main/llm/transformations.md
index e677f0a38..bcc3d14a4 100644
--- a/content/docs/kubernetes/main/llm/transformations.md
+++ b/content/docs/kubernetes/main/llm/transformations.md
@@ -4,22 +4,22 @@ weight: 70
 description: Dynamically compute and set LLM request fields using CEL expressions.
 test:
   llm-transformations:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/llm/transformations.md
+  - file: ${versionRoot}/llm/transformations.md
     path: llm-transformations
   llm-model-headers:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/llm/transformations.md
+  - file: ${versionRoot}/llm/transformations.md
     path: llm-model-headers
 ---
 
diff --git a/content/docs/kubernetes/main/llm/virtual-keys.md b/content/docs/kubernetes/main/llm/virtual-keys.md
index 6e89b42f4..b51791463 100644
--- a/content/docs/kubernetes/main/llm/virtual-keys.md
+++ b/content/docs/kubernetes/main/llm/virtual-keys.md
@@ -4,30 +4,30 @@ weight: 30
 description: Issue API keys with per-key token budgets and cost tracking (also known as virtual keys).
 test:
   virtual-keys-auth:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/main/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys
-  - file: content/docs/kubernetes/main/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys-httpbun-test
   virtual-keys-ratelimit:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/httpbun.md
+  - file: ${versionRoot}/llm/providers/httpbun.md
     path: setup-httpbun-llm
-  - file: content/docs/kubernetes/main/security/rate-limit-global.md
+  - file: ${versionRoot}/security/rate-limit-global.md
     path: deploy-rate-limit-server
-  - file: content/docs/kubernetes/main/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys
-  - file: content/docs/kubernetes/main/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys-with-ratelimit
-  - file: content/docs/kubernetes/main/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys-ratelimit-test
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/auth/keycloak.md b/content/docs/kubernetes/main/mcp/auth/keycloak.md
index 14def6f4f..9c9cac448 100644
--- a/content/docs/kubernetes/main/mcp/auth/keycloak.md
+++ b/content/docs/kubernetes/main/mcp/auth/keycloak.md
@@ -4,9 +4,9 @@ weight: 20
 description: Deploy and configure Keycloak as an OAuth identity provider for MCP authentication with agentgateway.
 test:
   setup-keycloak:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: experimental
-  - file: content/docs/kubernetes/main/mcp/auth/keycloak.md
+  - file: ${versionRoot}/mcp/auth/keycloak.md
     path: setup-keycloak
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/auth/setup.md b/content/docs/kubernetes/main/mcp/auth/setup.md
index cd4dc9a3a..953d46ba0 100644
--- a/content/docs/kubernetes/main/mcp/auth/setup.md
+++ b/content/docs/kubernetes/main/mcp/auth/setup.md
@@ -4,15 +4,15 @@ weight: 40
 description: Secure MCP servers with OAuth 2.0 authentication using agentgateway and an identity provider like Keycloak.
 test:
   mcp-auth-setup:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/main/mcp/auth/keycloak.md
+  - file: ${versionRoot}/mcp/auth/keycloak.md
     path: setup-keycloak
-  - file: content/docs/kubernetes/main/mcp/auth/setup.md
+  - file: ${versionRoot}/mcp/auth/setup.md
     path: mcp-auth-setup
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/dynamic-mcp.md b/content/docs/kubernetes/main/mcp/dynamic-mcp.md
index 1b4e8c538..7b854148c 100644
--- a/content/docs/kubernetes/main/mcp/dynamic-mcp.md
+++ b/content/docs/kubernetes/main/mcp/dynamic-mcp.md
@@ -4,11 +4,11 @@ weight: 20
 description: Route traffic to MCP servers dynamically using label selectors so backends can be updated without changing the Backend resource.
 test:
   dynamic-mcp:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/dynamic-mcp.md
+  - file: ${versionRoot}/mcp/dynamic-mcp.md
     path: dynamic-mcp
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/guardrails/setup.md b/content/docs/kubernetes/main/mcp/guardrails/setup.md
index 29154359e..c456b4626 100644
--- a/content/docs/kubernetes/main/mcp/guardrails/setup.md
+++ b/content/docs/kubernetes/main/mcp/guardrails/setup.md
@@ -4,11 +4,11 @@ weight: 20
 description: Gate and mutate MCP method calls with an external ExtMCP policy server.
 test:
   mcp-guardrails:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/guardrails/setup.md
+  - file: ${versionRoot}/mcp/guardrails/setup.md
     path: mcp-guardrails
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/rate-limit.md b/content/docs/kubernetes/main/mcp/rate-limit.md
index d15c9d21f..6ac3de687 100644
--- a/content/docs/kubernetes/main/mcp/rate-limit.md
+++ b/content/docs/kubernetes/main/mcp/rate-limit.md
@@ -4,13 +4,13 @@ weight: 65
 description: Control MCP tool call rates to prevent overload and ensure fair access to expensive tools.
 test:
   mcp-local-rate-limit:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/main/mcp/rate-limit.md
+  - file: ${versionRoot}/mcp/rate-limit.md
     path: mcp-local-rate-limit
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/static-mcp.md b/content/docs/kubernetes/main/mcp/static-mcp.md
index f71a61115..d90d28b2b 100644
--- a/content/docs/kubernetes/main/mcp/static-mcp.md
+++ b/content/docs/kubernetes/main/mcp/static-mcp.md
@@ -4,11 +4,11 @@ weight: 10
 description: Route traffic to an MCP server at a static address by configuring a fixed Backend resource.
 test:
   setup-mcp-server:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/static-mcp.md
+  - file: ${versionRoot}/mcp/static-mcp.md
     path: setup-mcp-server
 ---
 
diff --git a/content/docs/kubernetes/main/mcp/virtual.md b/content/docs/kubernetes/main/mcp/virtual.md
index fd30cc2c9..9d8b86b0c 100644
--- a/content/docs/kubernetes/main/mcp/virtual.md
+++ b/content/docs/kubernetes/main/mcp/virtual.md
@@ -4,11 +4,11 @@ weight: 30
 description: Federate tools from multiple MCP servers on a single gateway endpoint using virtual MCP multiplexing.
 test:
   virtual-mcp:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/mcp/virtual.md
+  - file: ${versionRoot}/mcp/virtual.md
     path: virtual-mcp
 ---
 
diff --git a/content/docs/kubernetes/main/observability/control-plane-metrics.md b/content/docs/kubernetes/main/observability/control-plane-metrics.md
index ba637029b..aa20d5ce3 100644
--- a/content/docs/kubernetes/main/observability/control-plane-metrics.md
+++ b/content/docs/kubernetes/main/observability/control-plane-metrics.md
@@ -4,9 +4,9 @@ description: Monitor control plane health and performance with Prometheus metric
 weight: 20
 test:
   control-plane-metrics:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/observability/control-plane-metrics.md
+  - file: ${versionRoot}/observability/control-plane-metrics.md
     path: control-plane-metrics
 ---
 
diff --git a/content/docs/kubernetes/main/observability/nacks.md b/content/docs/kubernetes/main/observability/nacks.md
index 28300fd7d..71b2bbe1d 100644
--- a/content/docs/kubernetes/main/observability/nacks.md
+++ b/content/docs/kubernetes/main/observability/nacks.md
@@ -4,11 +4,11 @@ description: Monitor and troubleshoot proxy configuration rejections with metric
 weight: 80
 test:
   nacks:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/observability/nacks.md
+  - file: ${versionRoot}/observability/nacks.md
     path: nacks
 ---
 
diff --git a/content/docs/kubernetes/main/observability/otel-stack.md b/content/docs/kubernetes/main/observability/otel-stack.md
index 14e5bde39..76dace2ca 100644
--- a/content/docs/kubernetes/main/observability/otel-stack.md
+++ b/content/docs/kubernetes/main/observability/otel-stack.md
@@ -4,13 +4,13 @@ description: Install an OpenTelemetry stack with Grafana, Loki, and Tempo for ob
 weight: 10
 test:
   otel-stack:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/observability/otel-stack.md
+  - file: ${versionRoot}/observability/otel-stack.md
     path: otel-stack
 ---
 
diff --git a/content/docs/kubernetes/main/observability/tracing.md b/content/docs/kubernetes/main/observability/tracing.md
index b55d12b79..4c4ebed23 100644
--- a/content/docs/kubernetes/main/observability/tracing.md
+++ b/content/docs/kubernetes/main/observability/tracing.md
@@ -4,13 +4,13 @@ description: Integrate with OpenTelemetry to collect and analyze request traces.
 weight: 90
 test:
   tracing:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/observability/tracing.md
+  - file: ${versionRoot}/observability/tracing.md
     path: tracing
 ---
 
diff --git a/content/docs/kubernetes/main/observability/ui.md b/content/docs/kubernetes/main/observability/ui.md
index 005a11a75..3acf4a7be 100644
--- a/content/docs/kubernetes/main/observability/ui.md
+++ b/content/docs/kubernetes/main/observability/ui.md
@@ -4,22 +4,22 @@ weight: 10
 description: Use the built-in Admin UI to inspect your Kubernetes agentgateway proxy configuration.
 test:
   admin-ui:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/observability/ui.md
+  - file: ${versionRoot}/observability/ui.md
     path: ui-k8s
   capture:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/quickstart/mcp.md
+  - file: ${versionRoot}/quickstart/mcp.md
     path: setup-mcp-server
-  - file: content/docs/kubernetes/main/quickstart/non-agentic-http.md
+  - file: ${versionRoot}/quickstart/non-agentic-http.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/observability/ui.md
+  - file: ${versionRoot}/observability/ui.md
     path: ui-k8s-capture
 ---
 
diff --git a/content/docs/kubernetes/main/operations/uninstall.md b/content/docs/kubernetes/main/operations/uninstall.md
index 2e0fb0b12..ecc115fc6 100644
--- a/content/docs/kubernetes/main/operations/uninstall.md
+++ b/content/docs/kubernetes/main/operations/uninstall.md
@@ -4,9 +4,9 @@ weight: 50
 description: Uninstall kgateway and related components.
 test:
   uninstall:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/operations/uninstall.md
+  - file: ${versionRoot}/operations/uninstall.md
     path: uninstall
 ---
 
diff --git a/content/docs/kubernetes/main/operations/upgrade.md b/content/docs/kubernetes/main/operations/upgrade.md
index d47b7d13c..7b0b43b43 100644
--- a/content/docs/kubernetes/main/operations/upgrade.md
+++ b/content/docs/kubernetes/main/operations/upgrade.md
@@ -4,9 +4,9 @@ weight: 20
 description: Upgrade the control plane and any gateway proxies that run in your cluster.
 test:
   upgrade:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/operations/upgrade.md
+  - file: ${versionRoot}/operations/upgrade.md
     path: upgrade
 ---
 
diff --git a/content/docs/kubernetes/main/quickstart/install.md b/content/docs/kubernetes/main/quickstart/install.md
index 18bbaac0b..977b9f228 100644
--- a/content/docs/kubernetes/main/quickstart/install.md
+++ b/content/docs/kubernetes/main/quickstart/install.md
@@ -4,7 +4,7 @@ weight: 10
 description: Install the agentgateway control plane in your Kubernetes cluster.
 test:
   install:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
 ---
 
diff --git a/content/docs/kubernetes/main/quickstart/llm.md b/content/docs/kubernetes/main/quickstart/llm.md
index f281bade0..845dcd7f4 100644
--- a/content/docs/kubernetes/main/quickstart/llm.md
+++ b/content/docs/kubernetes/main/quickstart/llm.md
@@ -4,9 +4,9 @@ weight: 11
 description: Route requests to OpenAI's chat completions API with agentgateway on Kubernetes.
 test:
   openai:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/quickstart/llm.md
+  - file: ${versionRoot}/quickstart/llm.md
     path: openai-setup
 ---
 
diff --git a/content/docs/kubernetes/main/quickstart/mcp.md b/content/docs/kubernetes/main/quickstart/mcp.md
index ec4e541eb..56091c46c 100644
--- a/content/docs/kubernetes/main/quickstart/mcp.md
+++ b/content/docs/kubernetes/main/quickstart/mcp.md
@@ -4,9 +4,9 @@ weight: 12
 description: Connect to an MCP server and try tools with agentgateway on Kubernetes.
 test:
   mcp:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/quickstart/mcp.md
+  - file: ${versionRoot}/quickstart/mcp.md
     path: setup-mcp-server
 ---
 
diff --git a/content/docs/kubernetes/main/quickstart/non-agentic-http.md b/content/docs/kubernetes/main/quickstart/non-agentic-http.md
index 1cb107e04..ebc90009c 100644
--- a/content/docs/kubernetes/main/quickstart/non-agentic-http.md
+++ b/content/docs/kubernetes/main/quickstart/non-agentic-http.md
@@ -4,9 +4,9 @@ weight: 13
 description: Route HTTP traffic to a backend such as httpbin with agentgateway on Kubernetes.
 test:
   httpbin:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/quickstart/non-agentic-http.md
+  - file: ${versionRoot}/quickstart/non-agentic-http.md
     path: install-httpbin
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/backend-health.md b/content/docs/kubernetes/main/resiliency/backend-health.md
index f5022dd60..cce65594b 100644
--- a/content/docs/kubernetes/main/resiliency/backend-health.md
+++ b/content/docs/kubernetes/main/resiliency/backend-health.md
@@ -4,13 +4,13 @@ weight: 15
 description: Automatically evict and restore unhealthy backend endpoints with passive health checking.
 test:
   backend-health:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/backend-health.md
+  - file: ${versionRoot}/resiliency/backend-health.md
     path: backend-health
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/connection.md b/content/docs/kubernetes/main/resiliency/connection.md
index 81712297d..ad31f82bf 100644
--- a/content/docs/kubernetes/main/resiliency/connection.md
+++ b/content/docs/kubernetes/main/resiliency/connection.md
@@ -4,33 +4,33 @@ weight: 10
 description: Configure and manage HTTP connections to an upstream service.
 test:
   connection-general:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/connection.md
+  - file: ${versionRoot}/resiliency/connection.md
     path: connection-general
 
   connection-http1:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/connection.md
+  - file: ${versionRoot}/resiliency/connection.md
     path: connection-http1
 
   connection-http2-flow:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/connection.md
+  - file: ${versionRoot}/resiliency/connection.md
     path: connection-http2-flow
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/keepalive.md b/content/docs/kubernetes/main/resiliency/keepalive.md
index a45160de8..2a99f541d 100644
--- a/content/docs/kubernetes/main/resiliency/keepalive.md
+++ b/content/docs/kubernetes/main/resiliency/keepalive.md
@@ -4,23 +4,23 @@ weight: 10
 description: Manage idle and stale connections with TCP and HTTP keepalive.
 test:
   tcp-keepalive:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/keepalive.md
+  - file: ${versionRoot}/resiliency/keepalive.md
     path: tcp-keepalive
 
   http-keepalive:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/keepalive.md
+  - file: ${versionRoot}/resiliency/keepalive.md
     path: http-keepalive
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md b/content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md
index f36b3b0b8..42858e582 100644
--- a/content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md
+++ b/content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md
@@ -4,31 +4,31 @@ weight: 20
 description: Set up per-try timeouts.
 test:
   per-try-timeout-in-httproute:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md
+  - file: ${versionRoot}/resiliency/retry/per-try-timeout.md
     path: per-try-timeout-in-httproute
   per-try-timeout-in-agentgateway:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md
+  - file: ${versionRoot}/resiliency/retry/per-try-timeout.md
     path: per-try-timeout-in-agentgateway
   per-try-timeout-in-gatewaylistener:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/retry/per-try-timeout.md
+  - file: ${versionRoot}/resiliency/retry/per-try-timeout.md
     path: per-try-timeout-in-gatewaylistener
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/retry/retry.md b/content/docs/kubernetes/main/resiliency/retry/retry.md
index 5d2fdbf4f..58b1633c9 100644
--- a/content/docs/kubernetes/main/resiliency/retry/retry.md
+++ b/content/docs/kubernetes/main/resiliency/retry/retry.md
@@ -4,31 +4,31 @@ weight: 10
 description: Set up retries for requests.
 test:
   retry-in-httproute:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/retry/retry.md
+  - file: ${versionRoot}/resiliency/retry/retry.md
     path: retry-in-httproute
   retry-in-agentgateway:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/retry/retry.md
+  - file: ${versionRoot}/resiliency/retry/retry.md
     path: retry-in-agentgateway
   retry-in-gatewaylistener:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/retry/retry.md
+  - file: ${versionRoot}/resiliency/retry/retry.md
     path: retry-in-gatewaylistener
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/timeouts/idle.md b/content/docs/kubernetes/main/resiliency/timeouts/idle.md
index a3083a7c9..ae8ba329b 100644
--- a/content/docs/kubernetes/main/resiliency/timeouts/idle.md
+++ b/content/docs/kubernetes/main/resiliency/timeouts/idle.md
@@ -4,13 +4,13 @@ weight: 20
 description: Set idle timeouts to terminate inactive HTTP/1 connections.
 test:
   idle-timeout:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/timeouts/idle.md
+  - file: ${versionRoot}/resiliency/timeouts/idle.md
     path: idle-timeout
 ---
 
diff --git a/content/docs/kubernetes/main/resiliency/timeouts/request.md b/content/docs/kubernetes/main/resiliency/timeouts/request.md
index fbb6d63d7..aa931ea42 100644
--- a/content/docs/kubernetes/main/resiliency/timeouts/request.md
+++ b/content/docs/kubernetes/main/resiliency/timeouts/request.md
@@ -4,31 +4,31 @@ weight: 10
 description: Configure timeouts for all routes in an HTTPRoute.
 test:
   timeout-in-httproute:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/timeouts/request.md
+  - file: ${versionRoot}/resiliency/timeouts/request.md
     path: timeout-in-httproute
   timeout-in-trafficpolicy:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/timeouts/request.md
+  - file: ${versionRoot}/resiliency/timeouts/request.md
     path: timeout-in-trafficpolicy
   timeout-in-gatewaylistener:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/resiliency/timeouts/request.md
+  - file: ${versionRoot}/resiliency/timeouts/request.md
     path: timeout-in-gatewaylistener
 ---
 
diff --git a/content/docs/kubernetes/main/security/access-logging.md b/content/docs/kubernetes/main/security/access-logging.md
index 136cb2a0e..0a197bf8d 100644
--- a/content/docs/kubernetes/main/security/access-logging.md
+++ b/content/docs/kubernetes/main/security/access-logging.md
@@ -4,13 +4,13 @@ weight: 10
 description: Capture an access log for all the requests that enter the proxy.
 test:
   access-logging:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/access-logging.md
+  - file: ${versionRoot}/security/access-logging.md
     path: access-logging
 ---
 
diff --git a/content/docs/kubernetes/main/security/cors.md b/content/docs/kubernetes/main/security/cors.md
index 37e13601c..d2430a80e 100644
--- a/content/docs/kubernetes/main/security/cors.md
+++ b/content/docs/kubernetes/main/security/cors.md
@@ -4,23 +4,23 @@ description: Configure cross-origin resource sharing policies for cross-origin r
 weight: 10
 test:
   cors-in-httproute:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/cors.md
+  - file: ${versionRoot}/security/cors.md
     path: cors-in-httproute
 
   cors-in-agentgatewaypolicy:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/cors.md
+  - file: ${versionRoot}/security/cors.md
     path: cors-in-agentgatewaypolicy
 ---
 
diff --git a/content/docs/kubernetes/main/security/csrf.md b/content/docs/kubernetes/main/security/csrf.md
index fc19bee6b..7c9b92a72 100644
--- a/content/docs/kubernetes/main/security/csrf.md
+++ b/content/docs/kubernetes/main/security/csrf.md
@@ -4,13 +4,13 @@ weight: 10
 description: Protect your applications from Cross-Site Request Forgery (CSRF) attacks.
 test:
   csrf:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/csrf.md
+  - file: ${versionRoot}/security/csrf.md
     path: csrf
 ---
 
diff --git a/content/docs/kubernetes/main/security/rate-limit-global.md b/content/docs/kubernetes/main/security/rate-limit-global.md
index 7dc9eaea8..1af634236 100644
--- a/content/docs/kubernetes/main/security/rate-limit-global.md
+++ b/content/docs/kubernetes/main/security/rate-limit-global.md
@@ -4,13 +4,13 @@ weight: 45
 description: Apply distributed rate limits across multiple agentgateway replicas using an external rate limit service.
 test:
   global-rate-limit-by-ip:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/rate-limit-global.md
+  - file: ${versionRoot}/security/rate-limit-global.md
     path: global-rate-limit-by-ip
 ---
 
diff --git a/content/docs/kubernetes/main/security/rate-limit-http.md b/content/docs/kubernetes/main/security/rate-limit-http.md
index d32656da0..e915c0db8 100644
--- a/content/docs/kubernetes/main/security/rate-limit-http.md
+++ b/content/docs/kubernetes/main/security/rate-limit-http.md
@@ -4,13 +4,13 @@ weight: 40
 description: Apply local and global rate limits to HTTP traffic to protect your backend services from overload.
 test:
   local-rate-limit:
-  - file: content/docs/kubernetes/main/install/helm.md
+  - file: ${versionRoot}/install/helm.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/rate-limit-http.md
+  - file: ${versionRoot}/security/rate-limit-http.md
     path: local-rate-limit
 ---
 
diff --git a/content/docs/kubernetes/main/setup/customize/customize.md b/content/docs/kubernetes/main/setup/customize/customize.md
index 0229d5e7e..13a104290 100644
--- a/content/docs/kubernetes/main/setup/customize/customize.md
+++ b/content/docs/kubernetes/main/setup/customize/customize.md
@@ -4,11 +4,11 @@ weight: 20
 description: Customize the agentgateway proxy for different deployment scenarios and requirements.
 test:
   customize:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/setup/customize/customize.md
+  - file: ${versionRoot}/setup/customize/customize.md
     path: customize
 ---
 
diff --git a/content/docs/kubernetes/main/setup/gateway.md b/content/docs/kubernetes/main/setup/gateway.md
index 4f000fbba..e83e0dc40 100644
--- a/content/docs/kubernetes/main/setup/gateway.md
+++ b/content/docs/kubernetes/main/setup/gateway.md
@@ -4,9 +4,9 @@ weight: 10
 description: Set up an agentgateway proxy with Gateway API resources and custom configuration.
 test:
   setup-gateway:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
 ---
 
diff --git a/content/docs/kubernetes/main/setup/listeners/http.md b/content/docs/kubernetes/main/setup/listeners/http.md
index 2a104c15c..41adf2959 100644
--- a/content/docs/kubernetes/main/setup/listeners/http.md
+++ b/content/docs/kubernetes/main/setup/listeners/http.md
@@ -4,13 +4,13 @@ weight: 10
 description: Create an HTTP listener on your gateway proxy to serve HTTPRoutes.
 test:
   http-listener:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/setup/listeners/http.md
+  - file: ${versionRoot}/setup/listeners/http.md
     path: http-listener
 ---
 
diff --git a/content/docs/kubernetes/main/setup/listeners/https.md b/content/docs/kubernetes/main/setup/listeners/https.md
index 85d998189..a1dc433c9 100644
--- a/content/docs/kubernetes/main/setup/listeners/https.md
+++ b/content/docs/kubernetes/main/setup/listeners/https.md
@@ -4,13 +4,13 @@ weight: 10
 description: Create an HTTPS listener on your gateway proxy to terminate TLS traffic.
 test:
   https-listener:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/setup/listeners/https.md
+  - file: ${versionRoot}/setup/listeners/https.md
     path: https-listener
 ---
 
diff --git a/content/docs/kubernetes/main/setup/listeners/tls-settings.md b/content/docs/kubernetes/main/setup/listeners/tls-settings.md
index 8c4db3568..0ce68dfe0 100644
--- a/content/docs/kubernetes/main/setup/listeners/tls-settings.md
+++ b/content/docs/kubernetes/main/setup/listeners/tls-settings.md
@@ -4,11 +4,11 @@ description: Configure advanced TLS settings such as cipher suites and protocol
 weight: 20
 test:
   tls-settings:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/setup/listeners/tls-settings.md
+  - file: ${versionRoot}/setup/listeners/tls-settings.md
     path: tls-settings
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/buffering.md b/content/docs/kubernetes/main/traffic-management/buffering.md
index 740564437..469604ccd 100644
--- a/content/docs/kubernetes/main/traffic-management/buffering.md
+++ b/content/docs/kubernetes/main/traffic-management/buffering.md
@@ -4,11 +4,11 @@ weight: 10
 description: Buffer requests and responses for inspection or replay.
 test:
   buffering:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/buffering.md
+  - file: ${versionRoot}/traffic-management/buffering.md
     path: buffering
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/dfp.md b/content/docs/kubernetes/main/traffic-management/dfp.md
index 2b1e69509..9b4378d1a 100644
--- a/content/docs/kubernetes/main/traffic-management/dfp.md
+++ b/content/docs/kubernetes/main/traffic-management/dfp.md
@@ -4,13 +4,13 @@ weight: 10
 description: Route traffic dynamically to upstream servers based on request characteristics.
 test:
   dfp:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/dfp.md
+  - file: ${versionRoot}/traffic-management/dfp.md
     path: dfp
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/direct-response.md b/content/docs/kubernetes/main/traffic-management/direct-response.md
index d3672b33a..f9e608057 100644
--- a/content/docs/kubernetes/main/traffic-management/direct-response.md
+++ b/content/docs/kubernetes/main/traffic-management/direct-response.md
@@ -4,13 +4,13 @@ weight: 10
 description: Return responses directly without forwarding to upstream services.
 test:
   direct-response:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/direct-response.md
+  - file: ${versionRoot}/traffic-management/direct-response.md
     path: direct-response
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/extproc.md b/content/docs/kubernetes/main/traffic-management/extproc.md
index cffb41585..c1473730c 100644
--- a/content/docs/kubernetes/main/traffic-management/extproc.md
+++ b/content/docs/kubernetes/main/traffic-management/extproc.md
@@ -4,13 +4,13 @@ weight: 10
 description: Modify requests and responses with an external gRPC processing server.
 test:
   extproc:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/extproc.md
+  - file: ${versionRoot}/traffic-management/extproc.md
     path: extproc
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/grpc.md b/content/docs/kubernetes/main/traffic-management/grpc.md
index 157ad27bb..c8c7acc3a 100644
--- a/content/docs/kubernetes/main/traffic-management/grpc.md
+++ b/content/docs/kubernetes/main/traffic-management/grpc.md
@@ -4,9 +4,9 @@ weight: 10
 description: Route and configure gRPC traffic in agentgateway.
 test:
   grpc:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/traffic-management/grpc.md
+  - file: ${versionRoot}/traffic-management/grpc.md
     path: grpc
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/header-control/early-request-header-modifier.md b/content/docs/kubernetes/main/traffic-management/header-control/early-request-header-modifier.md
index e8b3c7fc4..86d02c79b 100644
--- a/content/docs/kubernetes/main/traffic-management/header-control/early-request-header-modifier.md
+++ b/content/docs/kubernetes/main/traffic-management/header-control/early-request-header-modifier.md
@@ -4,13 +4,13 @@ weight: 30
 description: Modify request headers in the early phase of request processing.
 test:
   remove-reserved-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/early-request-header-modifier.md
+  - file: ${versionRoot}/traffic-management/header-control/early-request-header-modifier.md
     path: remove-reserved-header
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/header-control/request-header.md b/content/docs/kubernetes/main/traffic-management/header-control/request-header.md
index 3dc819a88..6b0925cb2 100644
--- a/content/docs/kubernetes/main/traffic-management/header-control/request-header.md
+++ b/content/docs/kubernetes/main/traffic-management/header-control/request-header.md
@@ -4,31 +4,31 @@ weight: 10
 description: Add, set, or remove request headers.
 test:
   add-request-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/request-header.md
+  - file: ${versionRoot}/traffic-management/header-control/request-header.md
     path: add-request-header
   set-request-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/request-header.md
+  - file: ${versionRoot}/traffic-management/header-control/request-header.md
     path: set-request-header
   remove-request-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/request-header.md
+  - file: ${versionRoot}/traffic-management/header-control/request-header.md
     path: remove-request-header
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/header-control/response-header.md b/content/docs/kubernetes/main/traffic-management/header-control/response-header.md
index 6e6732c73..2d900c080 100644
--- a/content/docs/kubernetes/main/traffic-management/header-control/response-header.md
+++ b/content/docs/kubernetes/main/traffic-management/header-control/response-header.md
@@ -4,31 +4,31 @@ weight: 20
 description: Add, set, or remove response headers.
 test:
   add-response-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/response-header.md
+  - file: ${versionRoot}/traffic-management/header-control/response-header.md
     path: add-response-header
   set-response-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/response-header.md
+  - file: ${versionRoot}/traffic-management/header-control/response-header.md
     path: set-response-header
   remove-response-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/header-control/response-header.md
+  - file: ${versionRoot}/traffic-management/header-control/response-header.md
     path: remove-response-header
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/locality-aware-routing.md b/content/docs/kubernetes/main/traffic-management/locality-aware-routing.md
index 9601a5ec4..e3e3b454d 100644
--- a/content/docs/kubernetes/main/traffic-management/locality-aware-routing.md
+++ b/content/docs/kubernetes/main/traffic-management/locality-aware-routing.md
@@ -4,9 +4,9 @@ weight: 50
 description: Reduce cross-zone traffic costs and latency with topology-aware routing, and fail over to other localities when local endpoints are unavailable.
 test:
   locality-aware-routing:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/traffic-management/locality-aware-routing.md
+  - file: ${versionRoot}/traffic-management/locality-aware-routing.md
     path: locality-aware-routing
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/match/header.md b/content/docs/kubernetes/main/traffic-management/match/header.md
index 142be77b7..09fcaddda 100644
--- a/content/docs/kubernetes/main/traffic-management/match/header.md
+++ b/content/docs/kubernetes/main/traffic-management/match/header.md
@@ -4,22 +4,22 @@ weight: 10
 description: Match requests by header values using exact or regex patterns.
 test:
   header-match-exact:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/header.md
+  - file: ${versionRoot}/traffic-management/match/header.md
     path: header-match-exact
   header-match-regex:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/header.md
+  - file: ${versionRoot}/traffic-management/match/header.md
     path: header-match-regex
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/match/host.md b/content/docs/kubernetes/main/traffic-management/match/host.md
index 0585aeaf5..1b42c32ac 100644
--- a/content/docs/kubernetes/main/traffic-management/match/host.md
+++ b/content/docs/kubernetes/main/traffic-management/match/host.md
@@ -4,13 +4,13 @@ weight: 10
 description: Match requests by hostname.
 test:
   host-match:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/host.md
+  - file: ${versionRoot}/traffic-management/match/host.md
     path: host-match
 ---
 Expose a route on multiple hosts. 
diff --git a/content/docs/kubernetes/main/traffic-management/match/method.md b/content/docs/kubernetes/main/traffic-management/match/method.md
index 2bea2e733..abc3ba1dd 100644
--- a/content/docs/kubernetes/main/traffic-management/match/method.md
+++ b/content/docs/kubernetes/main/traffic-management/match/method.md
@@ -4,13 +4,13 @@ weight: 10
 description: Match requests by HTTP method (GET, POST, PUT, PATCH, DELETE).
 test:
   method-match:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/method.md
+  - file: ${versionRoot}/traffic-management/match/method.md
     path: method-match
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/match/path.md b/content/docs/kubernetes/main/traffic-management/match/path.md
index 5a65598b9..183176e3b 100644
--- a/content/docs/kubernetes/main/traffic-management/match/path.md
+++ b/content/docs/kubernetes/main/traffic-management/match/path.md
@@ -4,31 +4,31 @@ weight: 10
 description: Match requests by path using exact, prefix, or regex patterns.
 test:
   path-match-exact:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/path.md
+  - file: ${versionRoot}/traffic-management/match/path.md
     path: path-match-exact
   path-match-prefix:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/path.md
+  - file: ${versionRoot}/traffic-management/match/path.md
     path: path-match-prefix
   path-match-regex:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/path.md
+  - file: ${versionRoot}/traffic-management/match/path.md
     path: path-match-regex
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/match/query.md b/content/docs/kubernetes/main/traffic-management/match/query.md
index 1c622d6b0..1f4f84997 100644
--- a/content/docs/kubernetes/main/traffic-management/match/query.md
+++ b/content/docs/kubernetes/main/traffic-management/match/query.md
@@ -4,13 +4,13 @@ weight: 10
 description: Specify a set of URL query parameters which requests must match in entirety.
 test:
   query-match:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/match/query.md
+  - file: ${versionRoot}/traffic-management/match/query.md
     path: query-match
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/redirect/host.md b/content/docs/kubernetes/main/traffic-management/redirect/host.md
index d51218b4b..d3a4242c2 100644
--- a/content/docs/kubernetes/main/traffic-management/redirect/host.md
+++ b/content/docs/kubernetes/main/traffic-management/redirect/host.md
@@ -4,13 +4,13 @@ weight: 442
 description: Redirect requests to a different host.
 test:
   host-redirect:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/redirect/host.md
+  - file: ${versionRoot}/traffic-management/redirect/host.md
     path: host-redirect
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/redirect/https.md b/content/docs/kubernetes/main/traffic-management/redirect/https.md
index 46658a31e..7e2186870 100644
--- a/content/docs/kubernetes/main/traffic-management/redirect/https.md
+++ b/content/docs/kubernetes/main/traffic-management/redirect/https.md
@@ -4,13 +4,13 @@ weight: 441
 description: Redirect HTTP traffic to HTTPS.
 test:
   https-redirect:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/redirect/https.md
+  - file: ${versionRoot}/traffic-management/redirect/https.md
     path: https-redirect
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/redirect/path.md b/content/docs/kubernetes/main/traffic-management/redirect/path.md
index 87b1f3171..b87e9cd2f 100644
--- a/content/docs/kubernetes/main/traffic-management/redirect/path.md
+++ b/content/docs/kubernetes/main/traffic-management/redirect/path.md
@@ -4,22 +4,22 @@ weight: 443
 description: Redirect requests to a different path prefix.
 test:
   path-redirect-prefix:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/redirect/path.md
+  - file: ${versionRoot}/traffic-management/redirect/path.md
     path: path-redirect-prefix
   path-redirect-full:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/redirect/path.md
+  - file: ${versionRoot}/traffic-management/redirect/path.md
     path: path-redirect-full
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/rewrite/host.md b/content/docs/kubernetes/main/traffic-management/rewrite/host.md
index df17bf96d..010b23735 100644
--- a/content/docs/kubernetes/main/traffic-management/rewrite/host.md
+++ b/content/docs/kubernetes/main/traffic-management/rewrite/host.md
@@ -4,13 +4,13 @@ weight: 461
 description: Replace the host header value before forwarding a request to a backend service.
 test:
   host-rewrite:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/rewrite/host.md
+  - file: ${versionRoot}/traffic-management/rewrite/host.md
     path: host-rewrite
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/rewrite/path.md b/content/docs/kubernetes/main/traffic-management/rewrite/path.md
index d6a8652ff..019c849be 100644
--- a/content/docs/kubernetes/main/traffic-management/rewrite/path.md
+++ b/content/docs/kubernetes/main/traffic-management/rewrite/path.md
@@ -4,22 +4,22 @@ weight: 462
 description: Rewrite path prefixes in requests.
 test:
   path-rewrite-prefix:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/rewrite/path.md
+  - file: ${versionRoot}/traffic-management/rewrite/path.md
     path: path-rewrite-prefix
   path-rewrite-full:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/rewrite/path.md
+  - file: ${versionRoot}/traffic-management/rewrite/path.md
     path: path-rewrite-full
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/route-delegation/basic.md b/content/docs/kubernetes/main/traffic-management/route-delegation/basic.md
index fa52bcad6..938875b8e 100644
--- a/content/docs/kubernetes/main/traffic-management/route-delegation/basic.md
+++ b/content/docs/kubernetes/main/traffic-management/route-delegation/basic.md
@@ -4,13 +4,13 @@ weight: 10
 description: Set up basic route delegation between a parent HTTPRoute and two child HTTPRoutes.
 test:
   basic:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/basic.md
+  - file: ${versionRoot}/traffic-management/route-delegation/basic.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/basic.md
+  - file: ${versionRoot}/traffic-management/route-delegation/basic.md
     path: basic
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/route-delegation/header-query.md b/content/docs/kubernetes/main/traffic-management/route-delegation/header-query.md
index 9ccede118..8a4de6f96 100644
--- a/content/docs/kubernetes/main/traffic-management/route-delegation/header-query.md
+++ b/content/docs/kubernetes/main/traffic-management/route-delegation/header-query.md
@@ -4,13 +4,13 @@ weight: 40
 description: Use header and query matchers in a route delegation setup.
 test:
   header-query:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/header-query.md
+  - file: ${versionRoot}/traffic-management/route-delegation/header-query.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/header-query.md
+  - file: ${versionRoot}/traffic-management/route-delegation/header-query.md
     path: header-query
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/native-policies.md b/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/native-policies.md
index e5d1cfff8..5dce7ba2e 100644
--- a/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/native-policies.md
+++ b/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/native-policies.md
@@ -4,13 +4,13 @@ weight: 10
 description: Learn how Kubernetes Gateway API policies, such as request timeouts, are inherited and overridden along the route delegation chain.
 test:
   native-policies:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/native-policies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/native-policies.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/native-policies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/native-policies.md
     path: native-policies
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/trafficpolicies.md b/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/trafficpolicies.md
index ce42ae475..8d0781eab 100644
--- a/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/trafficpolicies.md
+++ b/content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/trafficpolicies.md
@@ -4,13 +4,13 @@ weight: 20
 description: Learn how policies in `AgentgatewayPolicy` resources are inherited and overridden along the route delegation chain.
 test:
   trafficpolicies:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/trafficpolicies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/trafficpolicies.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/inheritance/trafficpolicies.md
+  - file: ${versionRoot}/traffic-management/route-delegation/inheritance/trafficpolicies.md
     path: trafficpolicies
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/route-delegation/label.md b/content/docs/kubernetes/main/traffic-management/route-delegation/label.md
index ff199f1f1..7926cca1e 100644
--- a/content/docs/kubernetes/main/traffic-management/route-delegation/label.md
+++ b/content/docs/kubernetes/main/traffic-management/route-delegation/label.md
@@ -4,13 +4,13 @@ weight: 20
 description: Use labels to delegate traffic to child HTTPRoutes with the `<key>=<value>` syntax.
 test:
   label:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/label.md
+  - file: ${versionRoot}/traffic-management/route-delegation/label.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/label.md
+  - file: ${versionRoot}/traffic-management/route-delegation/label.md
     path: label
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/route-delegation/multi-level-delegation.md b/content/docs/kubernetes/main/traffic-management/route-delegation/multi-level-delegation.md
index f511dfb9d..56e225bcd 100644
--- a/content/docs/kubernetes/main/traffic-management/route-delegation/multi-level-delegation.md
+++ b/content/docs/kubernetes/main/traffic-management/route-delegation/multi-level-delegation.md
@@ -4,13 +4,13 @@ weight: 30
 description: Create a 3-level route delegation hierarchy with a parent, child, and grandchild HTTPRoute.
 test:
   multi-level:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/multi-level-delegation.md
+  - file: ${versionRoot}/traffic-management/route-delegation/multi-level-delegation.md
     path: route-delegation-prereq
-  - file: content/docs/kubernetes/main/traffic-management/route-delegation/multi-level-delegation.md
+  - file: ${versionRoot}/traffic-management/route-delegation/multi-level-delegation.md
     path: multi-level
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/traffic-split.md b/content/docs/kubernetes/main/traffic-management/traffic-split.md
index 3dbf147d1..14c9f7c52 100644
--- a/content/docs/kubernetes/main/traffic-management/traffic-split.md
+++ b/content/docs/kubernetes/main/traffic-management/traffic-split.md
@@ -4,13 +4,13 @@ weight: 60
 description: Set up A/B testing, traffic splitting, and canary deployments using weighted routing.
 test:
   traffic-split-llm-models:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/traffic-management/traffic-split.md
+  - file: ${versionRoot}/traffic-management/traffic-split.md
     path: traffic-split-llm
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/access-logs.md b/content/docs/kubernetes/main/traffic-management/transformations/access-logs.md
index e5445d308..355c4202c 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/access-logs.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/access-logs.md
@@ -4,22 +4,22 @@ weight: 120
 description: Log CEL context variables to access logs to inspect and debug transformation expressions at runtime.
 test:
   access-logs:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/access-logs.md
+  - file: ${versionRoot}/traffic-management/transformations/access-logs.md
     path: access-logs
   access-logs-filter:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/access-logs.md
+  - file: ${versionRoot}/traffic-management/transformations/access-logs.md
     path: access-logs-filter
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/encode.md b/content/docs/kubernetes/main/traffic-management/transformations/encode.md
index f48035cea..a60518f3c 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/encode.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/encode.md
@@ -4,22 +4,22 @@ weight: 20
 description: Automatically encode and decode base64 values in request headers.
 test:
   encode:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/encode.md
+  - file: ${versionRoot}/traffic-management/transformations/encode.md
     path: encode
   decode:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/encode.md
+  - file: ${versionRoot}/traffic-management/transformations/encode.md
     path: decode
 ---
 {{< reuse "agw-docs/pages/traffic-management/transformations/encode.md" >}}
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/filter-request-body.md b/content/docs/kubernetes/main/traffic-management/transformations/filter-request-body.md
index b3bbd2509..ec5ac6866 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/filter-request-body.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/filter-request-body.md
@@ -4,13 +4,13 @@ weight: 60
 description: Use filterKeys() and merge() CEL functions to strip unwanted fields from a JSON request body and inject defaults before forwarding to the upstream.
 test:
   filter-request-body:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/filter-request-body.md
+  - file: ${versionRoot}/traffic-management/transformations/filter-request-body.md
     path: filter-request-body
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/forward.md b/content/docs/kubernetes/main/traffic-management/transformations/forward.md
index 737241ae5..a7dd77c7d 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/forward.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/forward.md
@@ -4,13 +4,13 @@ weight: 40
 description: Use CEL expressions to construct a full request URL from context variables and forward it upstream as a request header.
 test:
   forward:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/forward.md
+  - file: ${versionRoot}/traffic-management/transformations/forward.md
     path: forward
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/inject-response-body.md b/content/docs/kubernetes/main/traffic-management/transformations/inject-response-body.md
index 6fba08c0b..f5d8002e9 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/inject-response-body.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/inject-response-body.md
@@ -4,22 +4,22 @@ weight: 55
 description: Learn how to return a customized response body and how to replace specific values in the body.
 test:
   inject-header-into-body:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/inject-response-body.md
+  - file: ${versionRoot}/traffic-management/transformations/inject-response-body.md
     path: inject-header-into-body
   inject-body-field-into-body:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/inject-response-body.md
+  - file: ${versionRoot}/traffic-management/transformations/inject-response-body.md
     path: inject-body-field-into-body
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/inject-response-headers.md b/content/docs/kubernetes/main/traffic-management/transformations/inject-response-headers.md
index 01fa85d78..a69d3f775 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/inject-response-headers.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/inject-response-headers.md
@@ -4,13 +4,13 @@ weight: 5
 description: Extract values from a request header and inject it as a header to your response.
 test:
   inject-response-headers:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/inject-response-headers.md
+  - file: ${versionRoot}/traffic-management/transformations/inject-response-headers.md
     path: inject-response-headers
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/llm-model-headers.md b/content/docs/kubernetes/main/traffic-management/transformations/llm-model-headers.md
index f2bd1b042..c6eb9f8cb 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/llm-model-headers.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/llm-model-headers.md
@@ -4,25 +4,24 @@ weight: 47
 description: Detect model fallback by injecting the requested and actual LLM model names as response headers using llm.requestModel and llm.responseModel CEL variables.
 test:
   llm-transformations:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/traffic-management/transformations/llm-model-headers.md
+  - file: ${versionRoot}/traffic-management/transformations/llm-model-headers.md
     path: llm-transformations
 
   llm-model-headers:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/llm/providers/openai.md
+  - file: ${versionRoot}/llm/providers/openai.md
     path: openai-setup
-  - file: content/docs/kubernetes/main/traffic-management/transformations/llm-model-headers.md
+  - file: ${versionRoot}/traffic-management/transformations/llm-model-headers.md
     path: llm-model-headers
-
 ---
 
 {{< reuse "agw-docs/pages/agentgateway/llm/transformations.md" >}}
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/path-method.md b/content/docs/kubernetes/main/traffic-management/transformations/path-method.md
index 02b4c6067..ef2b7afd6 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/path-method.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/path-method.md
@@ -4,13 +4,13 @@ weight: 45
 description: Use pseudo headers to conditionally rewrite the request path and HTTP method based on a request header value.
 test:
   path-method:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/path-method.md
+  - file: ${versionRoot}/traffic-management/transformations/path-method.md
     path: path-method
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/query.md b/content/docs/kubernetes/main/traffic-management/transformations/query.md
index 324384b29..29e47d76a 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/query.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/query.md
@@ -4,13 +4,13 @@ weight: 46
 description: Read a query parameter from the request URI and inject it as a request header using a CEL conditional expression.
 test:
   query:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/query.md
+  - file: ${versionRoot}/traffic-management/transformations/query.md
     path: query
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/remove-header.md b/content/docs/kubernetes/main/traffic-management/transformations/remove-header.md
index c46e2787d..cbfabc497 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/remove-header.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/remove-header.md
@@ -4,13 +4,13 @@ weight: 50
 description: Remove sensitive or internal headers from requests before they reach the upstream.
 test:
   remove-header:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/remove-header.md
+  - file: ${versionRoot}/traffic-management/transformations/remove-header.md
     path: remove-header
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/rewrite.md b/content/docs/kubernetes/main/traffic-management/transformations/rewrite.md
index 3e1d4e638..5832f15ca 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/rewrite.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/rewrite.md
@@ -4,13 +4,13 @@ weight: 30
 description: Use CEL functions to rewrite request paths in a header.
 test:
   rewrite:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/rewrite.md
+  - file: ${versionRoot}/traffic-management/transformations/rewrite.md
     path: rewrite
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/status.md b/content/docs/kubernetes/main/traffic-management/transformations/status.md
index 42900ccc9..6f47d560e 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/status.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/status.md
@@ -4,13 +4,13 @@ weight: 60
 description: Update the response status based on the headers in a response.
 test:
   change-response-status:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/status.md
+  - file: ${versionRoot}/traffic-management/transformations/status.md
     path: change-response-status
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/tracing.md b/content/docs/kubernetes/main/traffic-management/transformations/tracing.md
index 3b081be26..044e1405d 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/tracing.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/tracing.md
@@ -4,13 +4,13 @@ weight: 10
 description: Use uuid() and random() CEL functions to inject a unique request ID and a random sampling value into request headers.
 test:
   tracing:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/tracing.md
+  - file: ${versionRoot}/traffic-management/transformations/tracing.md
     path: tracing
 ---
 
diff --git a/content/docs/kubernetes/main/traffic-management/transformations/validate.md b/content/docs/kubernetes/main/traffic-management/transformations/validate.md
index eae3e6292..313066d79 100644
--- a/content/docs/kubernetes/main/traffic-management/transformations/validate.md
+++ b/content/docs/kubernetes/main/traffic-management/transformations/validate.md
@@ -4,22 +4,22 @@ weight: 70
 description: Use default() and fail() CEL functions to enforce required fields and apply default values on a JSON request body.
 test:
   validate-defaults:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/validate.md
+  - file: ${versionRoot}/traffic-management/transformations/validate.md
     path: validate-defaults
   validate-skip:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/traffic-management/transformations/validate.md
+  - file: ${versionRoot}/traffic-management/transformations/validate.md
     path: validate-skip
 ---
 
diff --git a/content/docs/standalone/latest/integrations/observability/grafana.md b/content/docs/standalone/latest/integrations/observability/grafana.md
index b17473704..7bd9142e7 100644
--- a/content/docs/standalone/latest/integrations/observability/grafana.md
+++ b/content/docs/standalone/latest/integrations/observability/grafana.md
@@ -4,7 +4,7 @@ weight: 30
 description: Visualize agentgateway metrics and traces with Grafana
 test:
   grafana:
-  - file: content/docs/standalone/latest/integrations/observability/grafana.md
+  - file: ${versionRoot}/integrations/observability/grafana.md
     path: grafana
 ---
 
diff --git a/content/docs/standalone/latest/llm/api-types/realtime.md b/content/docs/standalone/latest/llm/api-types/realtime.md
index 912da1a66..ea3c837b0 100644
--- a/content/docs/standalone/latest/llm/api-types/realtime.md
+++ b/content/docs/standalone/latest/llm/api-types/realtime.md
@@ -4,7 +4,7 @@ weight: 40
 description: Proxy OpenAI Realtime API WebSocket traffic and track token usage.
 test:
   realtime-standalone:
-  - file: content/docs/standalone/latest/llm/api-types/realtime.md
+  - file: ${versionRoot}/llm/api-types/realtime.md
     path: realtime-standalone
 ---
 
@@ -26,12 +26,7 @@ The `realtime` route type supports token usage tracking and observability. Other
 
 {{< doc-test paths="realtime-standalone" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 export OPENAI_API_KEY="${OPENAI_API_KEY:-test}"
 {{< /doc-test >}}
 
diff --git a/content/docs/standalone/latest/llm/costs.md b/content/docs/standalone/latest/llm/costs.md
index 0f3a80508..b8a789052 100644
--- a/content/docs/standalone/latest/llm/costs.md
+++ b/content/docs/standalone/latest/llm/costs.md
@@ -4,7 +4,7 @@ weight: 51
 description: Price LLM requests with a model cost catalog and expose realized USD costs in logs, traces, metrics, and CEL policies.
 test:
   costs:
-  - file: content/docs/standalone/main/llm/costs.md
+  - file: ${versionRoot}/llm/costs.md
     path: costs
 aliases:
   - /llm/spending/
diff --git a/content/docs/standalone/latest/llm/providers/custom.md b/content/docs/standalone/latest/llm/providers/custom.md
index 27c44d982..055b65bd6 100644
--- a/content/docs/standalone/latest/llm/providers/custom.md
+++ b/content/docs/standalone/latest/llm/providers/custom.md
@@ -5,7 +5,7 @@ description: Configure agentgateway for providers without built-in support that
 aliases: /llm/providers/openai-compatible
 test:
   openai-compatible-validate:
-  - file: content/docs/standalone/main/llm/providers/openai-compatible.md
+  - file: ${versionRoot}/llm/providers/custom.md
     path: openai-compat-validate
 ---
 
@@ -28,12 +28,7 @@ You also need the following prerequisites.
 
 {{< doc-test paths="openai-compat-validate" >}}
 # Install agentgateway binary for testing
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 
 # Set placeholder API keys for validation (--validate-only still resolves env vars)
 export PERPLEXITY_API_KEY="${PERPLEXITY_API_KEY:-test}"
diff --git a/content/docs/standalone/latest/llm/providers/ollama.md b/content/docs/standalone/latest/llm/providers/ollama.md
index c91dab0a7..e91d7980e 100644
--- a/content/docs/standalone/latest/llm/providers/ollama.md
+++ b/content/docs/standalone/latest/llm/providers/ollama.md
@@ -5,7 +5,7 @@ icon: /integrations/providers/bw/ollama.svg
 description: Configure agentgateway to route LLM traffic to Ollama for local model inference
 test:
   ollama-standalone-validate:
-  - file: content/docs/standalone/latest/llm/providers/ollama.md
+  - file: ${versionRoot}/llm/providers/ollama.md
     path: ollama-standalone-validate
 ---
 
@@ -17,12 +17,7 @@ Local providers like Ollama usually run over HTTP and do not require `llm.models
 
 {{< doc-test paths="ollama-standalone-validate" >}}
 # Install agentgateway binary for testing
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 
 # Write and validate the ollama config from the guide
 cat > /tmp/test-ollama-standalone.yaml << 'EOF'
diff --git a/content/docs/standalone/latest/llm/transformations.md b/content/docs/standalone/latest/llm/transformations.md
index d7c9ea2d2..1e7410ba6 100644
--- a/content/docs/standalone/latest/llm/transformations.md
+++ b/content/docs/standalone/latest/llm/transformations.md
@@ -4,7 +4,7 @@ weight: 55
 description: Dynamically compute and set LLM request fields using CEL expressions.
 test:
   transformations:
-  - file: content/docs/standalone/latest/llm/transformations.md
+  - file: ${versionRoot}/llm/transformations.md
     path: transformations
 ---
 
@@ -25,12 +25,7 @@ Try out CEL expressions in the built-in [CEL playground]({{< link-hextra path="/
 
 {{< doc-test paths="transformations" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 ## Configure LLM request transformations
diff --git a/content/docs/standalone/latest/llm/virtual-keys.md b/content/docs/standalone/latest/llm/virtual-keys.md
index 045347cc4..e70cf1273 100644
--- a/content/docs/standalone/latest/llm/virtual-keys.md
+++ b/content/docs/standalone/latest/llm/virtual-keys.md
@@ -4,7 +4,7 @@ weight: 32
 description: Issue API keys with per-key token budgets and cost tracking (also known as virtual keys).
 test:
   virtual-keys:
-  - file: content/docs/standalone/latest/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys
 ---
 
diff --git a/content/docs/standalone/latest/mcp/mcp-authz.md b/content/docs/standalone/latest/mcp/mcp-authz.md
index 7c1b19e2b..aefa9a4ee 100644
--- a/content/docs/standalone/latest/mcp/mcp-authz.md
+++ b/content/docs/standalone/latest/mcp/mcp-authz.md
@@ -4,7 +4,7 @@ weight: 40
 description: Control access to MCP tools and resources with CEL-based authorization rules
 test:
   mcp-authz-tools:
-  - file: content/docs/standalone/latest/mcp/mcp-authz.md
+  - file: ${versionRoot}/mcp/mcp-authz.md
     path: mcp-authz-tools
 ---
 
@@ -19,12 +19,7 @@ The `mcpAuthorization` policy is attached at the backend level, where it applies
 
 {{< doc-test paths="mcp-authz-tools" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 ## Allow specific tools
diff --git a/content/docs/standalone/latest/operations/trace-requests.md b/content/docs/standalone/latest/operations/trace-requests.md
index 8bcea8114..39a91b6e1 100644
--- a/content/docs/standalone/latest/operations/trace-requests.md
+++ b/content/docs/standalone/latest/operations/trace-requests.md
@@ -4,7 +4,7 @@ weight: 16
 description: Capture a per-request trace as a standalone agentgateway instance handles the request.
 test:
   trace-validate:
-  - file: content/docs/standalone/latest/operations/trace-requests.md
+  - file: ${versionRoot}/operations/trace-requests.md
     path: trace-validate
 ---
 
diff --git a/content/docs/standalone/latest/operations/ui.md b/content/docs/standalone/latest/operations/ui.md
index e04f644ce..556c0b19a 100644
--- a/content/docs/standalone/latest/operations/ui.md
+++ b/content/docs/standalone/latest/operations/ui.md
@@ -4,10 +4,10 @@ weight: 10
 description: Use the built-in Admin UI to inspect and manage your standalone agentgateway configuration.
 test:
   admin-ui-default-port:
-  - file: content/docs/standalone/latest/operations/ui.md
+  - file: ${versionRoot}/operations/ui.md
     path: ui-standalone-default
   admin-ui-custom-port:
-  - file: content/docs/standalone/latest/operations/ui.md
+  - file: ${versionRoot}/operations/ui.md
     path: ui-standalone-custom-port
 ---
 
diff --git a/content/docs/standalone/latest/quickstart/llm.md b/content/docs/standalone/latest/quickstart/llm.md
index 89a8cdc75..14c8d0ff4 100644
--- a/content/docs/standalone/latest/quickstart/llm.md
+++ b/content/docs/standalone/latest/quickstart/llm.md
@@ -4,7 +4,7 @@ weight: 11
 description: Route requests to OpenAI's chat completions API with the agentgateway binary.
 test:
   llm-openai:
-  - file: content/docs/standalone/latest/quickstart/llm.md
+  - file: ${versionRoot}/quickstart/llm.md
     path: llm
 ---
 
diff --git a/content/docs/standalone/latest/quickstart/mcp.md b/content/docs/standalone/latest/quickstart/mcp.md
index fc4a075b2..0c2df0eab 100644
--- a/content/docs/standalone/latest/quickstart/mcp.md
+++ b/content/docs/standalone/latest/quickstart/mcp.md
@@ -6,7 +6,7 @@ description: Connect to an MCP server and try tools in the agentgateway playgrou
 # block in the shared snippet reproduces the equivalent config + backends so this stays tested.
 test:
   mcp-playground:
-  - file: content/docs/standalone/latest/quickstart/mcp.md
+  - file: ${versionRoot}/quickstart/mcp.md
     path: mcp
 ---
 
diff --git a/content/docs/standalone/latest/quickstart/non-agentic-http.md b/content/docs/standalone/latest/quickstart/non-agentic-http.md
index 01d9dad75..054bb638b 100644
--- a/content/docs/standalone/latest/quickstart/non-agentic-http.md
+++ b/content/docs/standalone/latest/quickstart/non-agentic-http.md
@@ -4,7 +4,7 @@ weight: 13
 description: Route HTTP traffic to a non-agentic backend such as httpbin with the agentgateway binary.
 test:
   non-agentic-http:
-  - file: content/docs/standalone/latest/quickstart/non-agentic-http.md
+  - file: ${versionRoot}/quickstart/non-agentic-http.md
     path: httpbin
 ---
 
diff --git a/content/docs/standalone/main/configuration/backends.md b/content/docs/standalone/main/configuration/backends.md
index 7131d9140..c22759b2f 100644
--- a/content/docs/standalone/main/configuration/backends.md
+++ b/content/docs/standalone/main/configuration/backends.md
@@ -5,7 +5,7 @@ description: Configure backends to route traffic to hostnames, LLM providers, an
 prev: /configuration/listeners
 test:
   backends:
-  - file: content/docs/standalone/main/configuration/backends.md
+  - file: ${versionRoot}/configuration/backends.md
     path: backends
 ---
 
diff --git a/content/docs/standalone/main/configuration/listeners.md b/content/docs/standalone/main/configuration/listeners.md
index 6d1dd0401..446dd50da 100644
--- a/content/docs/standalone/main/configuration/listeners.md
+++ b/content/docs/standalone/main/configuration/listeners.md
@@ -4,7 +4,7 @@ weight: 12
 description: Configure listeners for agentgateway.
 test:
   listeners:
-  - file: content/docs/standalone/main/configuration/listeners.md
+  - file: ${versionRoot}/configuration/listeners.md
     path: listeners
 ---
 
diff --git a/content/docs/standalone/main/configuration/resiliency/mirroring.md b/content/docs/standalone/main/configuration/resiliency/mirroring.md
index 4203c4f9d..d44b2dcfd 100644
--- a/content/docs/standalone/main/configuration/resiliency/mirroring.md
+++ b/content/docs/standalone/main/configuration/resiliency/mirroring.md
@@ -4,7 +4,7 @@ weight: 10
 description: Send copies of requests to alternative backends for shadow testing.
 test:
   mirroring:
-  - file: content/docs/standalone/main/configuration/resiliency/mirroring.md
+  - file: ${versionRoot}/configuration/resiliency/mirroring.md
     path: mirroring
 ---
 
diff --git a/content/docs/standalone/main/configuration/resiliency/rate-limits.md b/content/docs/standalone/main/configuration/resiliency/rate-limits.md
index 6b8951b7c..7f55dc51b 100644
--- a/content/docs/standalone/main/configuration/resiliency/rate-limits.md
+++ b/content/docs/standalone/main/configuration/resiliency/rate-limits.md
@@ -4,7 +4,7 @@ weight: 10
 description: Enforce budget and spend limits per key by controlling request and token usage.
 test:
   rate-limits:
-  - file: content/docs/standalone/main/configuration/resiliency/rate-limits.md
+  - file: ${versionRoot}/configuration/resiliency/rate-limits.md
     path: rate-limits
 ---
 
diff --git a/content/docs/standalone/main/configuration/resiliency/retries.md b/content/docs/standalone/main/configuration/resiliency/retries.md
index 6aa671a0c..7784f44ad 100644
--- a/content/docs/standalone/main/configuration/resiliency/retries.md
+++ b/content/docs/standalone/main/configuration/resiliency/retries.md
@@ -4,7 +4,7 @@ weight: 10
 description: Configure automatic retry attempts for failed backend requests.
 test:
   retries:
-  - file: content/docs/standalone/main/configuration/resiliency/retries.md
+  - file: ${versionRoot}/configuration/resiliency/retries.md
     path: retries
 ---
 
diff --git a/content/docs/standalone/main/configuration/resiliency/timeouts.md b/content/docs/standalone/main/configuration/resiliency/timeouts.md
index e7be6f2ec..2609da5dd 100644
--- a/content/docs/standalone/main/configuration/resiliency/timeouts.md
+++ b/content/docs/standalone/main/configuration/resiliency/timeouts.md
@@ -4,7 +4,7 @@ weight: 10
 description: Set request and backend timeouts to prevent long-running requests.
 test:
   timeouts:
-  - file: content/docs/standalone/main/configuration/resiliency/timeouts.md
+  - file: ${versionRoot}/configuration/resiliency/timeouts.md
     path: timeouts
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/apikey-authn.md b/content/docs/standalone/main/configuration/security/apikey-authn.md
index 1ae2a328f..3ef907d7a 100644
--- a/content/docs/standalone/main/configuration/security/apikey-authn.md
+++ b/content/docs/standalone/main/configuration/security/apikey-authn.md
@@ -4,7 +4,7 @@ weight: 17
 description: Authenticate requests using API keys with configurable validation modes.
 test:
   apikey-authn:
-  - file: content/docs/standalone/main/configuration/security/apikey-authn.md
+  - file: ${versionRoot}/configuration/security/apikey-authn.md
     path: apikey-authn
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/backend-authn.md b/content/docs/standalone/main/configuration/security/backend-authn.md
index 9c4f4ee1b..93fef3cf8 100644
--- a/content/docs/standalone/main/configuration/security/backend-authn.md
+++ b/content/docs/standalone/main/configuration/security/backend-authn.md
@@ -4,7 +4,7 @@ weight: 10
 description: Attach authentication tokens to outgoing backend requests.
 test:
   backend-authn:
-  - file: content/docs/standalone/main/configuration/security/backend-authn.md
+  - file: ${versionRoot}/configuration/security/backend-authn.md
     path: backend-authn
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/backend-tls.md b/content/docs/standalone/main/configuration/security/backend-tls.md
index 06f7ed095..703364f69 100644
--- a/content/docs/standalone/main/configuration/security/backend-tls.md
+++ b/content/docs/standalone/main/configuration/security/backend-tls.md
@@ -4,7 +4,7 @@ weight: 10
 description: Configure TLS for secure connections to backend services.
 test:
   backend-tls:
-  - file: content/docs/standalone/main/configuration/security/backend-tls.md
+  - file: ${versionRoot}/configuration/security/backend-tls.md
     path: backend-tls
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/basic-authn.md b/content/docs/standalone/main/configuration/security/basic-authn.md
index 5e9c81ff2..182ba1003 100644
--- a/content/docs/standalone/main/configuration/security/basic-authn.md
+++ b/content/docs/standalone/main/configuration/security/basic-authn.md
@@ -4,7 +4,7 @@ weight: 16
 description: Configure simple username and password authentication for your routes.
 test:
   basic-authn:
-  - file: content/docs/standalone/main/configuration/security/basic-authn.md
+  - file: ${versionRoot}/configuration/security/basic-authn.md
     path: basic-authn
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/csrf.md b/content/docs/standalone/main/configuration/security/csrf.md
index 0f0479df9..76309b965 100644
--- a/content/docs/standalone/main/configuration/security/csrf.md
+++ b/content/docs/standalone/main/configuration/security/csrf.md
@@ -4,7 +4,7 @@ weight: 11
 description: Protect against cross-site request forgery attacks with origin validation.
 test:
   csrf:
-  - file: content/docs/standalone/main/configuration/security/csrf.md
+  - file: ${versionRoot}/configuration/security/csrf.md
     path: csrf
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/external-authz.md b/content/docs/standalone/main/configuration/security/external-authz.md
index f1b3cca26..c941ee105 100644
--- a/content/docs/standalone/main/configuration/security/external-authz.md
+++ b/content/docs/standalone/main/configuration/security/external-authz.md
@@ -4,7 +4,7 @@ weight: 20
 description: Delegate authorization decisions to external services like OPA.
 test:
   external-authz:
-  - file: content/docs/standalone/main/configuration/security/external-authz.md
+  - file: ${versionRoot}/configuration/security/external-authz.md
     path: external-authz
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/http-authz.md b/content/docs/standalone/main/configuration/security/http-authz.md
index 96199901f..9b751cc26 100644
--- a/content/docs/standalone/main/configuration/security/http-authz.md
+++ b/content/docs/standalone/main/configuration/security/http-authz.md
@@ -4,7 +4,7 @@ weight: 12
 description: Define allow, deny, and require rules using CEL expressions.
 test:
   http-authz:
-  - file: content/docs/standalone/main/configuration/security/http-authz.md
+  - file: ${versionRoot}/configuration/security/http-authz.md
     path: http-authz
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/jwt-authn.md b/content/docs/standalone/main/configuration/security/jwt-authn.md
index 5ac65f0ac..a81a9323f 100644
--- a/content/docs/standalone/main/configuration/security/jwt-authn.md
+++ b/content/docs/standalone/main/configuration/security/jwt-authn.md
@@ -4,7 +4,7 @@ weight: 15
 description: Verify JWT tokens from incoming requests using JWKS and configured issuers.
 test:
   jwt-authn:
-  - file: content/docs/standalone/main/configuration/security/jwt-authn.md
+  - file: ${versionRoot}/configuration/security/jwt-authn.md
     path: jwt-authn
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/mcp-authn.md b/content/docs/standalone/main/configuration/security/mcp-authn.md
index 7a2418193..22fdf17d1 100644
--- a/content/docs/standalone/main/configuration/security/mcp-authn.md
+++ b/content/docs/standalone/main/configuration/security/mcp-authn.md
@@ -4,7 +4,7 @@ weight: 30
 description: Configure OAuth 2.0 protection for MCP servers with JWT validation.
 test:
   mcp-authn:
-  - file: content/docs/standalone/main/configuration/security/mcp-authn.md
+  - file: ${versionRoot}/configuration/security/mcp-authn.md
     path: mcp-authn
 ---
 
diff --git a/content/docs/standalone/main/configuration/security/mcp-authz.md b/content/docs/standalone/main/configuration/security/mcp-authz.md
index 42df944f4..031d9e569 100644
--- a/content/docs/standalone/main/configuration/security/mcp-authz.md
+++ b/content/docs/standalone/main/configuration/security/mcp-authz.md
@@ -4,7 +4,7 @@ weight: 40
 description: Define authorization rules for MCP method invocations using CEL expressions.
 test:
   mcp-authz-config:
-  - file: content/docs/standalone/main/configuration/security/mcp-authz.md
+  - file: ${versionRoot}/configuration/security/mcp-authz.md
     path: mcp-authz-config
 ---
 
diff --git a/content/docs/standalone/main/configuration/traffic-management/direct-response.md b/content/docs/standalone/main/configuration/traffic-management/direct-response.md
index f1c0284f7..8c049850b 100644
--- a/content/docs/standalone/main/configuration/traffic-management/direct-response.md
+++ b/content/docs/standalone/main/configuration/traffic-management/direct-response.md
@@ -4,7 +4,7 @@ weight: 14
 description: Return custom responses directly without forwarding to a backend.
 test:
   direct-response:
-  - file: content/docs/standalone/main/configuration/traffic-management/direct-response.md
+  - file: ${versionRoot}/configuration/traffic-management/direct-response.md
     path: direct-response
 ---
 
diff --git a/content/docs/standalone/main/configuration/traffic-management/manipulation.md b/content/docs/standalone/main/configuration/traffic-management/manipulation.md
index 975eca2bd..a8e8358d1 100644
--- a/content/docs/standalone/main/configuration/traffic-management/manipulation.md
+++ b/content/docs/standalone/main/configuration/traffic-management/manipulation.md
@@ -4,7 +4,7 @@ weight: 10
 description: Add, set, or remove HTTP request and response headers.
 test:
   manipulation:
-  - file: content/docs/standalone/main/configuration/traffic-management/manipulation.md
+  - file: ${versionRoot}/configuration/traffic-management/manipulation.md
     path: manipulation
 ---
 
diff --git a/content/docs/standalone/main/configuration/traffic-management/matching.md b/content/docs/standalone/main/configuration/traffic-management/matching.md
index 2bcf7751f..bc22b3f8f 100644
--- a/content/docs/standalone/main/configuration/traffic-management/matching.md
+++ b/content/docs/standalone/main/configuration/traffic-management/matching.md
@@ -4,7 +4,7 @@ weight: 9
 description: Match incoming requests by path, headers, methods, and query parameters.
 test:
   matching:
-  - file: content/docs/standalone/main/configuration/traffic-management/matching.md
+  - file: ${versionRoot}/configuration/traffic-management/matching.md
     path: matching
 ---
 
diff --git a/content/docs/standalone/main/configuration/traffic-management/redirects.md b/content/docs/standalone/main/configuration/traffic-management/redirects.md
index ad64a44ac..479e41787 100644
--- a/content/docs/standalone/main/configuration/traffic-management/redirects.md
+++ b/content/docs/standalone/main/configuration/traffic-management/redirects.md
@@ -4,7 +4,7 @@ weight: 11
 description: Return direct redirect responses to send users to another location.
 test:
   redirects:
-  - file: content/docs/standalone/main/configuration/traffic-management/redirects.md
+  - file: ${versionRoot}/configuration/traffic-management/redirects.md
     path: redirects
 ---
 
diff --git a/content/docs/standalone/main/configuration/traffic-management/rewrites.md b/content/docs/standalone/main/configuration/traffic-management/rewrites.md
index 95a8cd466..bc9296b6f 100644
--- a/content/docs/standalone/main/configuration/traffic-management/rewrites.md
+++ b/content/docs/standalone/main/configuration/traffic-management/rewrites.md
@@ -4,7 +4,7 @@ weight: 13
 description: Modify URL hostnames and paths of incoming requests dynamically.
 test:
   rewrites:
-  - file: content/docs/standalone/main/configuration/traffic-management/rewrites.md
+  - file: ${versionRoot}/configuration/traffic-management/rewrites.md
     path: rewrites
 ---
 
diff --git a/content/docs/standalone/main/configuration/traffic-management/transformations.md b/content/docs/standalone/main/configuration/traffic-management/transformations.md
index ce3e252bd..42b92612b 100644
--- a/content/docs/standalone/main/configuration/traffic-management/transformations.md
+++ b/content/docs/standalone/main/configuration/traffic-management/transformations.md
@@ -4,7 +4,7 @@ weight: 12
 description: Modify header and body information for requests and responses. 
 test:
   transformations:
-  - file: content/docs/standalone/main/configuration/traffic-management/transformations.md
+  - file: ${versionRoot}/configuration/traffic-management/transformations.md
     path: transformations
 ---
 
diff --git a/content/docs/standalone/main/integrations/observability/grafana.md b/content/docs/standalone/main/integrations/observability/grafana.md
index 2a5ce8463..7bd9142e7 100644
--- a/content/docs/standalone/main/integrations/observability/grafana.md
+++ b/content/docs/standalone/main/integrations/observability/grafana.md
@@ -4,7 +4,7 @@ weight: 30
 description: Visualize agentgateway metrics and traces with Grafana
 test:
   grafana:
-  - file: content/docs/standalone/main/integrations/observability/grafana.md
+  - file: ${versionRoot}/integrations/observability/grafana.md
     path: grafana
 ---
 
diff --git a/content/docs/standalone/main/llm/api-types/realtime.md b/content/docs/standalone/main/llm/api-types/realtime.md
index 22a1b6e6f..ea3c837b0 100644
--- a/content/docs/standalone/main/llm/api-types/realtime.md
+++ b/content/docs/standalone/main/llm/api-types/realtime.md
@@ -4,7 +4,7 @@ weight: 40
 description: Proxy OpenAI Realtime API WebSocket traffic and track token usage.
 test:
   realtime-standalone:
-  - file: content/docs/standalone/main/llm/api-types/realtime.md
+  - file: ${versionRoot}/llm/api-types/realtime.md
     path: realtime-standalone
 ---
 
@@ -26,12 +26,7 @@ The `realtime` route type supports token usage tracking and observability. Other
 
 {{< doc-test paths="realtime-standalone" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 export OPENAI_API_KEY="${OPENAI_API_KEY:-test}"
 {{< /doc-test >}}
 
diff --git a/content/docs/standalone/main/llm/costs.md b/content/docs/standalone/main/llm/costs.md
index 0f3a80508..b8a789052 100644
--- a/content/docs/standalone/main/llm/costs.md
+++ b/content/docs/standalone/main/llm/costs.md
@@ -4,7 +4,7 @@ weight: 51
 description: Price LLM requests with a model cost catalog and expose realized USD costs in logs, traces, metrics, and CEL policies.
 test:
   costs:
-  - file: content/docs/standalone/main/llm/costs.md
+  - file: ${versionRoot}/llm/costs.md
     path: costs
 aliases:
   - /llm/spending/
diff --git a/content/docs/standalone/main/llm/providers/custom.md b/content/docs/standalone/main/llm/providers/custom.md
index 27c44d982..055b65bd6 100644
--- a/content/docs/standalone/main/llm/providers/custom.md
+++ b/content/docs/standalone/main/llm/providers/custom.md
@@ -5,7 +5,7 @@ description: Configure agentgateway for providers without built-in support that
 aliases: /llm/providers/openai-compatible
 test:
   openai-compatible-validate:
-  - file: content/docs/standalone/main/llm/providers/openai-compatible.md
+  - file: ${versionRoot}/llm/providers/custom.md
     path: openai-compat-validate
 ---
 
@@ -28,12 +28,7 @@ You also need the following prerequisites.
 
 {{< doc-test paths="openai-compat-validate" >}}
 # Install agentgateway binary for testing
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 
 # Set placeholder API keys for validation (--validate-only still resolves env vars)
 export PERPLEXITY_API_KEY="${PERPLEXITY_API_KEY:-test}"
diff --git a/content/docs/standalone/main/llm/providers/ollama.md b/content/docs/standalone/main/llm/providers/ollama.md
index 4adad2dd0..e91d7980e 100644
--- a/content/docs/standalone/main/llm/providers/ollama.md
+++ b/content/docs/standalone/main/llm/providers/ollama.md
@@ -5,7 +5,7 @@ icon: /integrations/providers/bw/ollama.svg
 description: Configure agentgateway to route LLM traffic to Ollama for local model inference
 test:
   ollama-standalone-validate:
-  - file: content/docs/standalone/main/llm/providers/ollama.md
+  - file: ${versionRoot}/llm/providers/ollama.md
     path: ollama-standalone-validate
 ---
 
@@ -17,12 +17,7 @@ Local providers like Ollama usually run over HTTP and do not require `llm.models
 
 {{< doc-test paths="ollama-standalone-validate" >}}
 # Install agentgateway binary for testing
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 
 # Write and validate the ollama config from the guide
 cat > /tmp/test-ollama-standalone.yaml << 'EOF'
diff --git a/content/docs/standalone/main/llm/transformations.md b/content/docs/standalone/main/llm/transformations.md
index 3eb670e74..1e7410ba6 100644
--- a/content/docs/standalone/main/llm/transformations.md
+++ b/content/docs/standalone/main/llm/transformations.md
@@ -4,7 +4,7 @@ weight: 55
 description: Dynamically compute and set LLM request fields using CEL expressions.
 test:
   transformations:
-  - file: content/docs/standalone/main/llm/transformations.md
+  - file: ${versionRoot}/llm/transformations.md
     path: transformations
 ---
 
@@ -25,12 +25,7 @@ Try out CEL expressions in the built-in [CEL playground]({{< link-hextra path="/
 
 {{< doc-test paths="transformations" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 ## Configure LLM request transformations
diff --git a/content/docs/standalone/main/llm/virtual-keys.md b/content/docs/standalone/main/llm/virtual-keys.md
index 4353f9289..e70cf1273 100644
--- a/content/docs/standalone/main/llm/virtual-keys.md
+++ b/content/docs/standalone/main/llm/virtual-keys.md
@@ -4,7 +4,7 @@ weight: 32
 description: Issue API keys with per-key token budgets and cost tracking (also known as virtual keys).
 test:
   virtual-keys:
-  - file: content/docs/standalone/main/llm/virtual-keys.md
+  - file: ${versionRoot}/llm/virtual-keys.md
     path: virtual-keys
 ---
 
diff --git a/content/docs/standalone/main/mcp/mcp-authz.md b/content/docs/standalone/main/mcp/mcp-authz.md
index 06dd0aac6..aefa9a4ee 100644
--- a/content/docs/standalone/main/mcp/mcp-authz.md
+++ b/content/docs/standalone/main/mcp/mcp-authz.md
@@ -4,7 +4,7 @@ weight: 40
 description: Control access to MCP tools and resources with CEL-based authorization rules
 test:
   mcp-authz-tools:
-  - file: content/docs/standalone/main/mcp/mcp-authz.md
+  - file: ${versionRoot}/mcp/mcp-authz.md
     path: mcp-authz-tools
 ---
 
@@ -19,12 +19,7 @@ The `mcpAuthorization` policy is attached at the backend level, where it applies
 
 {{< doc-test paths="mcp-authz-tools" >}}
 # Install agentgateway binary
-mkdir -p "$HOME/.local/bin"
-export PATH="$HOME/.local/bin:$PATH"
-VERSION="v{{< reuse "agw-docs/versions/n-patch.md" >}}"
-BINARY_URL="https://github.com/agentgateway/agentgateway/releases/download/${VERSION}/agentgateway-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')"
-curl -sL "$BINARY_URL" -o "$HOME/.local/bin/agentgateway"
-chmod +x "$HOME/.local/bin/agentgateway"
+{{< reuse "agw-docs/snippets/install-agentgateway-binary.md" >}}
 {{< /doc-test >}}
 
 ## Allow specific tools
diff --git a/content/docs/standalone/main/operations/trace-requests.md b/content/docs/standalone/main/operations/trace-requests.md
index 276bd71a1..39a91b6e1 100644
--- a/content/docs/standalone/main/operations/trace-requests.md
+++ b/content/docs/standalone/main/operations/trace-requests.md
@@ -4,7 +4,7 @@ weight: 16
 description: Capture a per-request trace as a standalone agentgateway instance handles the request.
 test:
   trace-validate:
-  - file: content/docs/standalone/main/operations/trace-requests.md
+  - file: ${versionRoot}/operations/trace-requests.md
     path: trace-validate
 ---
 
diff --git a/content/docs/standalone/main/operations/ui.md b/content/docs/standalone/main/operations/ui.md
index c7470fd64..556c0b19a 100644
--- a/content/docs/standalone/main/operations/ui.md
+++ b/content/docs/standalone/main/operations/ui.md
@@ -4,10 +4,10 @@ weight: 10
 description: Use the built-in Admin UI to inspect and manage your standalone agentgateway configuration.
 test:
   admin-ui-default-port:
-  - file: content/docs/standalone/main/operations/ui.md
+  - file: ${versionRoot}/operations/ui.md
     path: ui-standalone-default
   admin-ui-custom-port:
-  - file: content/docs/standalone/main/operations/ui.md
+  - file: ${versionRoot}/operations/ui.md
     path: ui-standalone-custom-port
 ---
 
diff --git a/content/docs/standalone/main/quickstart/llm.md b/content/docs/standalone/main/quickstart/llm.md
index 8063d826a..14c8d0ff4 100644
--- a/content/docs/standalone/main/quickstart/llm.md
+++ b/content/docs/standalone/main/quickstart/llm.md
@@ -4,7 +4,7 @@ weight: 11
 description: Route requests to OpenAI's chat completions API with the agentgateway binary.
 test:
   llm-openai:
-  - file: content/docs/standalone/main/quickstart/llm.md
+  - file: ${versionRoot}/quickstart/llm.md
     path: llm
 ---
 
diff --git a/content/docs/standalone/main/quickstart/mcp.md b/content/docs/standalone/main/quickstart/mcp.md
index fe7638d84..0c2df0eab 100644
--- a/content/docs/standalone/main/quickstart/mcp.md
+++ b/content/docs/standalone/main/quickstart/mcp.md
@@ -6,7 +6,7 @@ description: Connect to an MCP server and try tools in the agentgateway playgrou
 # block in the shared snippet reproduces the equivalent config + backends so this stays tested.
 test:
   mcp-playground:
-  - file: content/docs/standalone/main/quickstart/mcp.md
+  - file: ${versionRoot}/quickstart/mcp.md
     path: mcp
 ---
 
diff --git a/content/docs/standalone/main/quickstart/non-agentic-http.md b/content/docs/standalone/main/quickstart/non-agentic-http.md
index 433e68552..054bb638b 100644
--- a/content/docs/standalone/main/quickstart/non-agentic-http.md
+++ b/content/docs/standalone/main/quickstart/non-agentic-http.md
@@ -4,7 +4,7 @@ weight: 13
 description: Route HTTP traffic to a non-agentic backend such as httpbin with the agentgateway binary.
 test:
   non-agentic-http:
-  - file: content/docs/standalone/main/quickstart/non-agentic-http.md
+  - file: ${versionRoot}/quickstart/non-agentic-http.md
     path: httpbin
 ---
 
diff --git a/playwright/scripts/resolve-image.mjs b/playwright/scripts/resolve-image.mjs
index 291acfc6f..d4876d149 100644
--- a/playwright/scripts/resolve-image.mjs
+++ b/playwright/scripts/resolve-image.mjs
@@ -9,7 +9,7 @@
  *   node resolve-image.mjs latest            -> ghcr.io/agentgateway/agentgateway:v1.3.1
  *   node resolve-image.mjs main              -> ghcr.io/agentgateway/agentgateway:latest-dev
  *   node resolve-image.mjs latest patch      -> 1.3.1
- *   node resolve-image.mjs main chart-version-> v0.0.0-latest-dev   (matches helm.md)
+ *   node resolve-image.mjs main chart-version-> 0.0.0-latest-dev    (matches helm.md)
  *
  * Mapping rule (no hugo.yaml parse needed): n-patch keys each version line to a patch.
  * The line whose patch is a dev string (e.g. 0.0.0-latest-dev) is `main`; `latest` is the
@@ -71,6 +71,13 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   const v = process.argv[2] || process.env.DOC_VERSION || 'latest';
   const what = process.argv[3] || 'image';
   if (what === 'patch') console.log(resolvePatch(v));
-  else if (what === 'chart-version') console.log(`v${resolvePatch(v)}`);
+  else if (what === 'chart-version') {
+    // Released charts are tagged vX.Y.Z; the floating dev chart is published
+    // as the bare nightly tag (0.0.0-latest-dev, no leading "v"). Mirror the
+    // conditional "v" in helm-version-flag.md so screenshot capture installs
+    // the same chart tag the docs (and doc tests) install.
+    const patch = resolvePatch(v);
+    console.log(isDev(patch) ? patch : `v${patch}`);
+  }
   else console.log(resolveImage(v));
 }
diff --git a/scripts/TEST_FRAMEWORK.md b/scripts/TEST_FRAMEWORK.md
index 31b19e719..bb8c3fa74 100644
--- a/scripts/TEST_FRAMEWORK.md
+++ b/scripts/TEST_FRAMEWORK.md
@@ -69,32 +69,53 @@ The `paths=` attribute works identically to fenced blocks.
 
 On the page being tested, add a `test:` key to the YAML front matter. Each child key is a named test scenario. Each entry in the list is a `file`+`path` pair — a source file and the path selector to pull from it.
 
+### Version-relative `file:` values
+
+So that a page can be copied between `main` and `latest` without editing its front matter, prefer **version-relative** `file:` values over hardcoded paths. The runner resolves these against the page that declares the test:
+
+- **Omit `file:` entirely** when the source is the **declaring page itself**. `file:` defaults to the page that the `test:` block lives on.
+- **Use `${versionRoot}`** for sources in the **same version** as the declaring page. `${versionRoot}` expands to the path up to and including the version directory (e.g. `content/docs/kubernetes/main` for a page under `main/`). `${version}` is also available and expands to just the version segment (e.g. `main`).
+
+Both tokens are derived from the declaring page's own path, so a page copied from `main/` to `latest/` resolves every `${versionRoot}` to the new version directory with no edits. The literal-path form still works and is the right choice when an entry must point at a *different* version on purpose.
+
+> The `${...}` syntax (not `{...}`) is deliberate: a YAML value starting with `{` is parsed as a flow mapping and would need quoting, whereas a leading `$` is a plain scalar, so `${versionRoot}/...` is valid unquoted.
+
 ```yaml
 ---
 title: CORS
 test:
   cors-in-httproute:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: experimental
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/cors.md
-    path: cors-in-httproute
+  - path: cors-in-httproute            # file: omitted -> the declaring page
 
   cors-in-agentgatewaypolicy:
-  - file: content/docs/kubernetes/main/quickstart/install.md
+  - file: ${versionRoot}/quickstart/install.md
     path: standard
-  - file: content/docs/kubernetes/main/setup/gateway.md
+  - file: ${versionRoot}/setup/gateway.md
     path: all
-  - file: content/docs/kubernetes/main/install/sample-app.md
+  - file: ${versionRoot}/install/sample-app.md
     path: install-httpbin
-  - file: content/docs/kubernetes/main/security/cors.md
-    path: cors-in-agentgatewaypolicy
+  - path: cors-in-agentgatewaypolicy   # file: omitted -> the declaring page
 ---
 ```
 
+The literal equivalent (hardcoding `main`) is still accepted, but then copying the page to `latest` requires rewriting every `file:` line:
+
+```yaml
+  cors-in-httproute:
+  - file: content/docs/kubernetes/main/quickstart/install.md
+    path: experimental
+  - file: content/docs/kubernetes/main/security/cors.md
+    path: cors-in-httproute
+```
+
+> Token resolution currently applies to the `kubernetes` and `standalone` sections. A `file:` value that doesn't match the `content/docs/<section>/<version>/` layout is left unchanged.
+
 Multiple scenarios on the same page each get their own kind cluster and generated script.
 
 ---
@@ -445,7 +466,9 @@ On macOS, you might need to run either the `python3 scripts/doc_test_run.py` com
 
 **File paths differ between `latest` and `main`**
 
-When copying a test chain from `main` to `latest` (or vice versa), update every `file:` path in the front matter. A `main` chain references files under `content/docs/kubernetes/main/`, while `latest` uses `content/docs/kubernetes/latest/`. Using the wrong version directory causes the extractor to pull blocks from a different version's content, or fail silently if the file doesn't exist.
+Prefer version-relative `file:` values (`${versionRoot}/...`, or omit `file:` for the declaring page — see [Version-relative `file:` values](#version-relative-file-values)). A page written this way can be copied between `main` and `latest` with no front-matter edits, because the tokens resolve against the version directory of whichever page declares the test.
+
+If a chain still uses **literal** paths (e.g. `content/docs/kubernetes/main/...`), then when you copy it to `latest` you must update every `file:` line to the target version directory. Using the wrong version directory causes the extractor to pull blocks from a different version's content, or fail silently if the file doesn't exist.
 
 **Wrong prerequisite file paths**
 
diff --git a/scripts/doc_test_run.py b/scripts/doc_test_run.py
index e5c3331cb..4b5f1a248 100644
--- a/scripts/doc_test_run.py
+++ b/scripts/doc_test_run.py
@@ -78,6 +78,42 @@ def infer_version_from_sources(sources: List[Dict[str, str]], fallback: str) ->
     return fallback
 
 
+def version_path_tokens(doc_rel_path: str) -> Dict[str, str]:
+    """Build the path-substitution tokens for a page's `test:` metadata.
+
+    Derived from the declaring page's repo-relative path
+    (e.g. "content/docs/standalone/main/configuration/backends.md"):
+
+      ${version}     -> the version dir segment, e.g. "main" / "latest"
+      ${versionRoot} -> the prefix up to and including the version dir,
+                        e.g. "content/docs/standalone/main"
+
+    These let `file:` values reference paths without hardcoding the version
+    directory, which rotates every release. Resolution is anchored to the page
+    that declares the test, so a page copied from main/ to latest/ needs no
+    metadata edit. Entries that intentionally target another version just write
+    the literal path (no token). Returns an empty dict for paths that don't
+    match the content/docs/<section>/<version>/ layout, leaving `file:`
+    unchanged.
+
+    The ${...} syntax (not {...}) is deliberate: a YAML value starting with
+    "{" is parsed as a flow mapping, so a leading {versionRoot} would be a
+    parse error unless quoted. A leading "$" is a plain scalar, so ${versionRoot}
+    is valid unquoted at the start of a `file:` value.
+    """
+    parts = doc_rel_path.replace("\\", "/").split("/")
+    try:
+        idx = parts.index("docs")
+        section = parts[idx + 1]
+        version = parts[idx + 2]
+    except (ValueError, IndexError):
+        return {}
+    if section not in ("kubernetes", "standalone"):
+        return {}
+    version_root = "/".join(parts[: idx + 3])
+    return {"${versionRoot}": version_root, "${version}": version}
+
+
 def build_test_cases_from_file(
     repo_root: Path,
     md_file: Path,
@@ -112,13 +148,24 @@ def build_test_cases_from_file(
             continue
 
         sources: List[Dict[str, str]] = []
+        tokens = version_path_tokens(rel_doc)
         for entry in entries:
             if not isinstance(entry, dict):
                 continue
-            source_file = entry.get("file")
             source_path = entry.get("path")
-            if not source_file or not source_path:
+            if not source_path:
                 continue
+            # `file` defaults to the page that declares the test, and supports
+            # ${version}/${versionRoot} placeholders resolved against that page's
+            # path. This lets entries reference a path without hardcoding the
+            # version dir (which rotates every release), so a page copied from
+            # main/ to latest/ needs no metadata edit -- the version context is
+            # still inferred from the resolved path. Entries that intentionally
+            # point at another version (e.g. a latest/ page reusing main/'s code
+            # blocks) just write the literal path with no token.
+            source_file = entry.get("file") or rel_doc
+            for token, value in tokens.items():
+                source_file = source_file.replace(token, value)
             sources.append({"file": source_file, "path": source_path})
 
         if not sources: