diff --git a/.github/workflows/site-guides.yml b/.github/workflows/site-guides.yml
new file mode 100644
index 0000000000..8918d9a631
--- /dev/null
+++ b/.github/workflows/site-guides.yml
@@ -0,0 +1,78 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+name: Site Guides
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'site/content/guides/**'
+  pull_request:
+    branches: [ "main" ]
+    paths:
+      - 'site/content/guides/**'
+  workflow_dispatch:
+    # Allow manual execution
+
+jobs:
+  test-site-guides:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+      - name: Set up JDK 21
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: '3.14'
+      - name: Setup test environment
+        uses: ./.github/actions/setup-test-env
+
+      - name: Test site testing
+        working-directory: site/it
+        run: |
+          echo "::group::Setup"
+          python3 -m pip install --upgrade pip
+          python3 -m venv .venv
+          . .venv/bin/activate
+          UV_VERSION="$(cat pyproject.toml | grep -A1 tool.uv | grep -v tool.uv | grep required-version | sed 's/required-version *= *"\([^"]*\)".*/\1/')"
+          pip install "uv$UV_VERSION"
+          uv sync --all-packages
+          echo "::endgroup::"
+          echo "::group::pytest"
+          pytest
+          echo "::endgroup::"
+
+      - name: Free disk space
+        uses: ./.github/actions/free-disk-space
+      - name: Prepare Gradle build cache
+        uses: ./.github/actions/ci-incr-build-cache-prepare
+      - name: Guide testing
+        working-directory: site
+        run: it/markdown-testing.py
+      - name: Archive test results
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
+        if: always()
+        with:
+          name: upload-guides-test-artifacts
+          path: |
+            site/it/build/tests/**
diff --git a/build.gradle.kts b/build.gradle.kts
index ea4b96d90c..71aa3b1b5a 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -69,6 +69,7 @@ tasks.named<RatTask>("rat").configure {
 
   // Files copied from Docsy (ASLv2 licensed) don't have header
   excludes.add("site/layouts/docs/baseof.html")
+  excludes.add("site/layouts/guides/baseof.html")
   excludes.add("site/layouts/shortcodes/redoc-polaris.html")
   excludes.add("site/layouts/community/list.html")
   excludes.add("site/layouts/partials/navbar.html")
@@ -113,6 +114,12 @@ tasks.named<RatTask>("rat").configure {
   excludes.add("site/resources/_gen/**")
   excludes.add("node_modules/**")
 
+  // Guides testing
+  excludes.add("site/content/guides/ceph/**/*.keyring")
+  excludes.add("site/it/.idea")
+  excludes.add("/venv")
+  excludes.add("/getting-started") // it's a symlink
+
   // Python
   excludes.add("**/.venv/**")
   excludes.add("**/polaris-venv/**")
diff --git a/getting-started b/getting-started
new file mode 120000
index 0000000000..005fed0591
--- /dev/null
+++ b/getting-started
@@ -0,0 +1 @@
+site/content/guides/
\ No newline at end of file
diff --git a/getting-started/README.md b/getting-started/README.md
deleted file mode 100644
index 725a886634..0000000000
--- a/getting-started/README.md
+++ /dev/null
@@ -1,40 +0,0 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris
-
-You can quickly get started with Polaris by playing with the docker-compose examples provided in
-this directory. Each example has detailed instructions.
-
-## Prerequisites
-
-- [Docker](https://docs.docker.com/get-docker/)
-- [Docker Compose](https://docs.docker.com/compose/install/) 
-- [jq](https://stedolan.github.io/jq/download/) (for some examples)
-
-## Getting Started Examples
-
-- [Spark](spark): An example that uses an in-memory metastore, automatically bootstrapped, with
-  Apache Spark and a Jupyter notebook.
-
-- [Telemetry](telemetry): An example that includes Prometheus and Jaeger to collect metrics and
-  traces from Apache Polaris. This example automatically creates a `polaris_demo` catalog.
-
-- [Keycloak](keycloak): An example that uses Keycloak as an external identity provider (IDP) for
-  authentication.
diff --git a/site/content/guides/.it-setup/index.md b/site/content/guides/.it-setup/index.md
new file mode 100644
index 0000000000..83823b35a6
--- /dev/null
+++ b/site/content/guides/.it-setup/index.md
@@ -0,0 +1,68 @@
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+---
+
+# Guides CI setup, this is NOT a guide
+
+**This page is not rendered on the website.**
+
+The directory name starting with a `.` ensures that this page is executed by the guides integration tests
+before any other guide's code blocks.
+
+## Eager code block execution
+
+This code block is eagerly executed here to further skip the repeated and expensive Polaris image builds
+present in the guides' code blocks.
+
+```shell
+./gradlew \
+   :polaris-server:assemble \
+   :polaris-server:quarkusAppPartsBuild --rerun \
+   :polaris-admin:assemble \
+   :polaris-admin:quarkusAppPartsBuild --rerun \
+   -Dquarkus.container-image.build=true
+```
+
+## Ignored code blocks
+
+These code blocks are not executed in guide tests because the Docker images have already been generated.
+
+The `skip_all` directive is used to skip this and all following executions of the same code block,
+irrespective whether `skip_all` is present or not.
+
+> **Note:** The `skip_all` directive is only supported by the `shell` code block.
+
+> **Note:** The code block must be _exactly_ the same, including all whitespaces.
+
+```shell skip_all
+./gradlew \
+   :polaris-server:assemble \
+   :polaris-server:quarkusAppPartsBuild --rerun \
+   -Dquarkus.container-image.build=true
+```
+
+```shell skip_all
+./gradlew \
+   :polaris-server:assemble \
+   :polaris-server:quarkusAppPartsBuild --rerun \
+   :polaris-admin:assemble \
+   :polaris-admin:quarkusAppPartsBuild --rerun \
+   -Dquarkus.container-image.build=true
+```
diff --git a/getting-started/quickstart/README.md b/site/content/guides/README.md
similarity index 83%
rename from getting-started/quickstart/README.md
rename to site/content/guides/README.md
index 35846ba8f3..949d51d3a2 100644
--- a/getting-started/quickstart/README.md
+++ b/site/content/guides/README.md
@@ -6,9 +6,9 @@
   to you under the Apache License, Version 2.0 (the
   "License"); you may not use this file except in compliance
   with the License.  You may obtain a copy of the License at
-
+ 
    http://www.apache.org/licenses/LICENSE-2.0
-
+ 
   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -17,6 +17,6 @@
   under the License.
 -->
 
-# Apache Polaris Quickstart
+# Getting Started with Apache Polaris
 
-Please see the [quickstart guide](../../site/content/in-dev/unreleased/getting-started/quick-start.md) for more information.
+See the [Guides section on the web site](https://polaris.apache.org/guides) for more information.
diff --git a/site/content/guides/_index.md b/site/content/guides/_index.md
new file mode 100644
index 0000000000..7034b96457
--- /dev/null
+++ b/site/content/guides/_index.md
@@ -0,0 +1,159 @@
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Guides"
+title: "Apache Polaris Guides"
+weight: 200
+cascade:
+    type: docs
+menus:
+    main:
+        parent: Guides
+        weight: 1
+        identifier: overview
+        name: Overview
+---
+
+You can quickly get started with Polaris by playing with the docker-compose examples provided
+by the guides shown on the left of this page.
+Each guide has detailed instructions.
+
+## Prerequisites
+
+- [Docker](https://docs.docker.com/get-docker/)
+- [Docker Compose](https://docs.docker.com/compose/install/)
+- [jq](https://stedolan.github.io/jq/download/) (for some examples)
+
+## Getting Started Examples
+
+- [Spark](spark): An example that uses an in-memory metastore, automatically bootstrapped, with
+  Apache Spark and a Jupyter notebook.
+
+- [Telemetry](telemetry): An example that includes Prometheus and Jaeger to collect metrics and
+  traces from Apache Polaris. This example automatically creates a `polaris_demo` catalog.
+
+- [Keycloak](keycloak): An example that uses Keycloak as an external identity provider (IDP) for
+  authentication.
+
+## Authoring Guides
+
+Writing new or updating Guides, especially those that use Docker Compose, should follow these
+guidelines. This ensures that the examples work as expected and that the guides pass the tests
+run in CI and locally.
+
+### Running guides CI tests locally
+
+Requirements: Python 3.14 installed locally. Other Python 3 versions should work as well, but
+have not been validated.
+
+To run tests for all guides in `site/content/guides`, run
+```shell
+cd site/it
+./markdown-testing.py
+```
+
+To run tests for one or more guides in `site/content/guides`, use the following pattern:
+```shell
+cd site/it
+./markdown-testing.py content/guides/rustfs/index.md content/guides/telemetry/index.md
+```
+
+More information about guides-testing can be found in the `site/it/README.md` file in the
+[source repository](https://github.com/apache/polaris).
+
+### Constraints
+
+1. `docker compose` invocations must be on a single line in a `shell` code block.
+2. Spark SQL shell invocations must be the only statement `shell` code block in a guide.
+
+### Tips for Docker usage
+
+- Do not use any of the `--interactive` or `--tty` options
+
+### Tips for Docker Compose files
+
+- All "daemon" services should have a healthcheck and depend on it using
+  `condition: service_healthy`.
+- Always put port-mappings in quotes, for example:
+  ```yaml
+  ports:
+    - "9874:9874"
+  ```
+- "Final setup services," for example the service that sets up Polaris, are a bit
+  tricky to get right in the sense that those do not let `docker compose up --detach --wait`
+  fail.
+  The former docker-compose command would yield an error if any service exits.
+  To prevent this, setup-services should have a final "endless" command to keep them
+  running and have a health check to inform about its success.
+
+  "Intermediate setup services," for example the service to create a bucket, do **not**
+  and **should not** have a final `sleep` command, because that would delay the overall
+  startup. The Polaris service must depend on the intermediate service to setup a bucket
+  with the `condition` `service_completed_successfully`.
+
+  Working example:
+  ```yaml
+  polaris-setup:
+    image: alpine/curl:8.17.0
+    depends_on:
+      polaris:
+        condition: service_healthy
+    (...)
+    entrypoint: "/bin/sh"
+    command:
+      - "-c"
+      - >-
+        do_stuff &&
+        touch /tmp/polaris-setup-done &&
+        tail -f /dev/null
+    healthcheck:
+      test: ["CMD", "test", "-f", "/tmp/polaris-setup-done"]
+  ```
+- Take care to propagate _all_ failures of a setup service's commands.
+  This can be achieved by chaining the commands with `&&` and using `set -e` at the
+  beginning of executed scripts.
+- For `curl`, use the `--fail-with-body` or `--fail` options or add specialized logic
+  to validate the HTTP response code.
+- Service dependencies (`depends_on`) must be declared with the correct `condition`,
+  meaning to use the "Long syntax" as described in the
+  [Docker Compose documentation](https://docs.docker.com/compose/compose-file/compose-file-v3/#depends_on).
+- Dependencies on "setup" services MUST be declared using a syntax like this:
+  ```yaml
+  polaris:
+    image: apache/polaris:latest
+    depends_on:
+      setup_bucket:
+        condition: service_completed_successfully
+  ```  
+- Dependencies on "daemon" services with a "proper" health check should be declared using
+  a syntax like this:
+  ```yaml
+  polaris:
+    image: apache/polaris:latest
+    depends_on:
+      minio:
+        condition: service_healthy
+  ```
+
+### Tips for inspecting Docker compose logs
+
+When inspecting the logs of Docker Compose, watch the logged timestamps.
+The order of the log entries emitted by Docker Compose is not necessarily in the
+natural order of execution between different services.
+Timestamps of each log entry are emitted to the console and the test log files.
diff --git a/getting-started/assets/cloud_providers/await-s3.sh b/site/content/guides/assets/cloud_providers/await-s3.sh
similarity index 100%
rename from getting-started/assets/cloud_providers/await-s3.sh
rename to site/content/guides/assets/cloud_providers/await-s3.sh
diff --git a/getting-started/assets/cloud_providers/deploy-aws.sh b/site/content/guides/assets/cloud_providers/deploy-aws.sh
similarity index 96%
rename from getting-started/assets/cloud_providers/deploy-aws.sh
rename to site/content/guides/assets/cloud_providers/deploy-aws.sh
index a6fea1de1f..40e3f1dc64 100755
--- a/getting-started/assets/cloud_providers/deploy-aws.sh
+++ b/site/content/guides/assets/cloud_providers/deploy-aws.sh
@@ -94,4 +94,4 @@ export STORAGE_LOCATION="s3://$S3_BUCKET_NAME/quickstart_catalog/"
        -Dquarkus.container-image.build=true \
        --no-build-cache
 
-docker compose -p polaris -f getting-started/jdbc/docker-compose-bootstrap-db.yml -f getting-started/jdbc/docker-compose.yml up -d
+docker compose -p polaris -f site/content/guides/jdbc/docker-compose-bootstrap-db.yml -f site/content/guides/jdbc/docker-compose.yml up -d
diff --git a/getting-started/assets/cloud_providers/deploy-azure.sh b/site/content/guides/assets/cloud_providers/deploy-azure.sh
similarity index 94%
rename from getting-started/assets/cloud_providers/deploy-azure.sh
rename to site/content/guides/assets/cloud_providers/deploy-azure.sh
index 99f60015e2..3b11b3550a 100755
--- a/getting-started/assets/cloud_providers/deploy-azure.sh
+++ b/site/content/guides/assets/cloud_providers/deploy-azure.sh
@@ -75,7 +75,7 @@ az role assignment create \
 export AZURE_TENANT_ID=$(az account show --query tenantId -o tsv)
 export STORAGE_LOCATION="abfss://$STORAGE_CONTAINER_NAME@$STORAGE_ACCOUNT_NAME.dfs.core.windows.net/quickstart_catalog"
 
-cat >> getting-started/assets/trino-config/catalog/iceberg.properties << EOF
+cat >> site/content/guides/assets/trino-config/catalog/iceberg.properties << EOF
 fs.native-azure.enabled=true
 azure.auth-type=DEFAULT
 EOF
@@ -84,4 +84,4 @@ EOF
        -Dquarkus.container-image.build=true \
        --no-build-cache
 
-docker compose -p polaris -f getting-started/jdbc/docker-compose-bootstrap-db.yml -f getting-started/jdbc/docker-compose.yml up -d
+docker compose -p polaris -f site/content/guides/jdbc/docker-compose-bootstrap-db.yml -f site/content/guides/jdbc/docker-compose.yml up -d
diff --git a/getting-started/assets/cloud_providers/deploy-gcp.sh b/site/content/guides/assets/cloud_providers/deploy-gcp.sh
similarity index 95%
rename from getting-started/assets/cloud_providers/deploy-gcp.sh
rename to site/content/guides/assets/cloud_providers/deploy-gcp.sh
index f4fb457629..0cb686de8e 100755
--- a/getting-started/assets/cloud_providers/deploy-gcp.sh
+++ b/site/content/guides/assets/cloud_providers/deploy-gcp.sh
@@ -62,4 +62,4 @@ export STORAGE_LOCATION="gs://$GCS_BUCKET_NAME/quickstart_catalog/"
        -Dquarkus.container-image.build=true \
        --no-build-cache
 
-docker compose -p polaris -f getting-started/jdbc/docker-compose-bootstrap-db.yml -f getting-started/jdbc/docker-compose.yml up -d
+docker compose -p polaris -f site/content/guides/jdbc/docker-compose-bootstrap-db.yml -f site/content/guides/jdbc/docker-compose.yml up -d
diff --git a/getting-started/assets/keycloak/iceberg-realm.json b/site/content/guides/assets/keycloak/iceberg-realm.json
similarity index 100%
rename from getting-started/assets/keycloak/iceberg-realm.json
rename to site/content/guides/assets/keycloak/iceberg-realm.json
diff --git a/getting-started/assets/polaris/create-catalog.sh b/site/content/guides/assets/polaris/create-catalog.sh
similarity index 100%
rename from getting-started/assets/polaris/create-catalog.sh
rename to site/content/guides/assets/polaris/create-catalog.sh
diff --git a/getting-started/assets/polaris/obtain-token.sh b/site/content/guides/assets/polaris/obtain-token.sh
similarity index 100%
rename from getting-started/assets/polaris/obtain-token.sh
rename to site/content/guides/assets/polaris/obtain-token.sh
diff --git a/getting-started/assets/postgres/docker-compose-postgres.yml b/site/content/guides/assets/postgres/docker-compose-postgres.yml
similarity index 100%
rename from getting-started/assets/postgres/docker-compose-postgres.yml
rename to site/content/guides/assets/postgres/docker-compose-postgres.yml
diff --git a/getting-started/assets/postgres/postgresql.conf b/site/content/guides/assets/postgres/postgresql.conf
similarity index 100%
rename from getting-started/assets/postgres/postgresql.conf
rename to site/content/guides/assets/postgres/postgresql.conf
diff --git a/getting-started/assets/prometheus/prometheus.yml b/site/content/guides/assets/prometheus/prometheus.yml
similarity index 100%
rename from getting-started/assets/prometheus/prometheus.yml
rename to site/content/guides/assets/prometheus/prometheus.yml
diff --git a/getting-started/assets/trino-config/catalog/iceberg.properties b/site/content/guides/assets/trino-config/catalog/iceberg.properties
similarity index 100%
rename from getting-started/assets/trino-config/catalog/iceberg.properties
rename to site/content/guides/assets/trino-config/catalog/iceberg.properties
diff --git a/getting-started/ceph/.gitignore b/site/content/guides/ceph/.gitignore
similarity index 100%
rename from getting-started/ceph/.gitignore
rename to site/content/guides/ceph/.gitignore
diff --git a/getting-started/ceph/ceph-conf/ceph.conf b/site/content/guides/ceph/ceph-conf/ceph.conf
similarity index 100%
rename from getting-started/ceph/ceph-conf/ceph.conf
rename to site/content/guides/ceph/ceph-conf/ceph.conf
diff --git a/getting-started/ceph/docker-compose.yml b/site/content/guides/ceph/docker-compose.yml
similarity index 100%
rename from getting-started/ceph/docker-compose.yml
rename to site/content/guides/ceph/docker-compose.yml
diff --git a/getting-started/ceph/.env.example b/site/content/guides/ceph/dot-env.example
similarity index 100%
rename from getting-started/ceph/.env.example
rename to site/content/guides/ceph/dot-env.example
diff --git a/getting-started/ceph/README.md b/site/content/guides/ceph/index.md
similarity index 73%
rename from getting-started/ceph/README.md
rename to site/content/guides/ceph/index.md
index 6e8a948dce..2cb221cd83 100644
--- a/getting-started/ceph/README.md
+++ b/site/content/guides/ceph/index.md
@@ -1,23 +1,35 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris and Ceph
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Storage: Ceph"
+title: "Getting Started with Apache Polaris and Ceph"
+weight: 200
+tags:
+  - ceph
+  - object storage
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 200
+---
 
 ## Overview
 
@@ -28,7 +40,7 @@ It does not include STS (Security Token Service) or temporary credentials.
 All access to the Ceph RGW (RADOS Gateway) and Polaris integration uses static S3-style credentials (as configured via radosgw-admin user create).
 
 Spark is used as a query engine. This example assumes a local Spark installation.
-See the [Spark Notebooks Example](../spark/README.md) for a more advanced Spark setup.
+See the [Spark Notebooks Example](../spark/) for a more advanced Spark setup.
 
 ## Starting the Example
 
@@ -42,9 +54,15 @@ The services are started **in sequence**:
 
 Note: this example pulls the `apache/polaris:latest` image, but assumes the image is `1.2.0-incubating` or later. 
 
+<!-- Guide testing: go to the guide's directory, instead of the workspace directory
+```shell
+cd "$SITE_TEST_GUIDE_DIR"
+```
+-->
+
 ### 1. Copy the example environment file
 ```shell
-cp .env.example .env
+cp dot-env.example .env
 ```
 
 ### 2. Start the docker compose group by running the following command:
@@ -57,7 +75,7 @@ docker compose up -d
 docker exec ceph-mon1-1 ceph -s
 ```
 You should see something like:
-```yaml
+```
 cluster:
   id:     b2f59c4b-5f14-4f8c-a9b7-3b7998c76a0e
   health: HEALTH_WARN
diff --git a/getting-started/jdbc/docker-compose-bootstrap-db.yml b/site/content/guides/jdbc/docker-compose-bootstrap-db.yml
similarity index 100%
rename from getting-started/jdbc/docker-compose-bootstrap-db.yml
rename to site/content/guides/jdbc/docker-compose-bootstrap-db.yml
diff --git a/getting-started/jdbc/docker-compose.yml b/site/content/guides/jdbc/docker-compose.yml
similarity index 100%
rename from getting-started/jdbc/docker-compose.yml
rename to site/content/guides/jdbc/docker-compose.yml
diff --git a/getting-started/jdbc/README.md b/site/content/guides/jdbc/index.md
similarity index 62%
rename from getting-started/jdbc/README.md
rename to site/content/guides/jdbc/index.md
index a9866f4960..cab281d340 100644
--- a/getting-started/jdbc/README.md
+++ b/site/content/guides/jdbc/index.md
@@ -1,23 +1,36 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris, Relational JDBC, Postgres and Spark SQL
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Backend: JDBC, Postgres"
+title: "Getting Started with Apache Polaris, Relational JDBC, Postgres and Spark SQL"
+weight: 100
+tags:
+   - backend
+   - jdbc
+   - postgres
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 100
+---
 
 This example requires `jq` to be installed on your machine.
 
@@ -39,12 +52,18 @@ This example requires `jq` to be installed on your machine.
     export QUARKUS_DATASOURCE_JDBC_URL=jdbc:postgresql://postgres:5432/POLARIS
     export QUARKUS_DATASOURCE_USERNAME=postgres
     export QUARKUS_DATASOURCE_PASSWORD=postgres
-    export ASSETS_PATH=$(pwd)/getting-started/assets/
+    export ASSETS_PATH=$(pwd)/site/content/guides/assets/
     export CLIENT_ID=root
     export CLIENT_SECRET=s3cr3t
-    docker compose -f getting-started/jdbc/docker-compose-bootstrap-db.yml -f getting-started/assets/postgres/docker-compose-postgres.yml -f getting-started/jdbc/docker-compose.yml up
+    docker compose -f site/content/guides/jdbc/docker-compose-bootstrap-db.yml -f site/content/guides/assets/postgres/docker-compose-postgres.yml -f site/content/guides/jdbc/docker-compose.yml up
     ```
 
+<!-- Guide testing: do not exercise the expensive Docker compose setup.
+```shell
+exit 0
+```
+-->
+
 3. Using spark-sql: attach to the running spark-sql container:
 
     ```shell
diff --git a/getting-started/keycloak/docker-compose.yml b/site/content/guides/keycloak/docker-compose.yml
similarity index 100%
rename from getting-started/keycloak/docker-compose.yml
rename to site/content/guides/keycloak/docker-compose.yml
diff --git a/getting-started/keycloak/README.md b/site/content/guides/keycloak/index.md
similarity index 82%
rename from getting-started/keycloak/README.md
rename to site/content/guides/keycloak/index.md
index 327f6eda20..5fb2422bcf 100644
--- a/getting-started/keycloak/README.md
+++ b/site/content/guides/keycloak/index.md
@@ -1,23 +1,36 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris, External Authentication and Keycloak
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Authentication: Keycloak"
+title: "Getting Started with Apache Polaris, External Authentication and Keycloak"
+weight: 100
+tags:
+  - authorization
+  - keycloak
+  - idp
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 100
+---
 
 ## Overview
 
@@ -46,7 +59,7 @@ Polaris is configured with 3 realms:
   issued by both Polaris and Keycloak.
 
 For more information about how to configure Polaris with external authentication, see the
-[Polaris documentation](https://polaris.apache.org/in-dev/unreleased/managing-security/external-idp/).
+[Polaris documentation](../../in-dev/unreleased).
 
 ## Starting the Example
 
@@ -62,7 +75,7 @@ For more information about how to configure Polaris with external authentication
 2. Start the docker compose group by running the following command from the root of the repository:
 
     ```shell
-    docker compose -f getting-started/keycloak/docker-compose.yml up
+    docker compose -f site/content/guides/keycloak/docker-compose.yml up
     ```
 
 ## Requesting a Token
@@ -102,12 +115,13 @@ Polaris tokens are valid for 1 hour.
 Note: if you request a Polaris token for the `realm-external` realm, it will not work because Polaris won't issue tokens
 for this realm:
 
+<!-- the '|| true' is there to let Guides CI not fail on this command -->
 ```shell
 curl -v http://localhost:8181/api/catalog/v1/oauth/tokens \
   --user root:s3cr3t \
   -H 'Polaris-Realm: realm-external' \
   -d 'grant_type=client_credentials' \
-  -d 'scope=PRINCIPAL_ROLE:ALL'
+  -d 'scope=PRINCIPAL_ROLE:ALL' || true
 ```
 
 This will return a `501 Not Implemented` error because for this realm, the internal token endpoint has been deactivated.
@@ -164,11 +178,12 @@ You can access Polaris using the tokens you obtained above. The following exampl
 Note: you cannot mix tokens from different realms. For example, you cannot use a token from the `realm-internal` realm to access
 the `realm-mixed` realm:
 
+<!-- the '|| true' is there to let Guides CI not fail on this command -->
 ```shell
 curl -v http://localhost:8181/api/management/v1/catalogs \
   -H "Authorization: Bearer $polaris_token_realm_internal" \
   -H 'Polaris-Realm: realm-mixed' \
-  -H 'Accept: application/json'
+  -H 'Accept: application/json' || true
 ```
 
 This will return a `401 Unauthorized` error because the token is not valid for the `realm-mixed` realm.
@@ -198,11 +213,12 @@ both (both realms share the same OIDC tenant configuration).
 
 Note: you cannot use a Keycloak token to access the `realm-internal` realm:
 
+<!-- the '|| true' is there to let Guides CI not fail on this command -->
 ```shell
 curl -v http://localhost:8181/api/management/v1/catalogs \
   -H "Authorization: Bearer $keycloak_token" \
   -H 'Polaris-Realm: realm-internal' \
-  -H 'Accept: application/json'
+  -H 'Accept: application/json' || true
 ```
 
 This will return a `401 Unauthorized` error because the token is not valid for the `realm-internal` realm.
\ No newline at end of file
diff --git a/getting-started/minio/docker-compose.yml b/site/content/guides/minio/docker-compose.yml
similarity index 100%
rename from getting-started/minio/docker-compose.yml
rename to site/content/guides/minio/docker-compose.yml
diff --git a/getting-started/minio/README.md b/site/content/guides/minio/index.md
similarity index 62%
rename from getting-started/minio/README.md
rename to site/content/guides/minio/index.md
index 00cfc5f3a8..096b311e31 100644
--- a/getting-started/minio/README.md
+++ b/site/content/guides/minio/index.md
@@ -1,33 +1,46 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris and MinIO
-
-> [!WARNING]
-> Disclaimer: This getting-started example uses MinIO OSS for local testing only. MinIO OSS is in maintenance mode, and MinIO container images may no longer receive updates or security fixes.
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Storage: MinIO"
+title: "Getting Started with Apache Polaris and MinIO"
+weight: 200
+tags:
+   - minio
+   - object storage
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 200
+---
+
+{{< alert warning >}}
+**Disclaimer:** This guide uses MinIO OSS for local testing only. MinIO OSS is in maintenance mode, and MinIO container images may no longer receive updates or security fixes.
+{{< /alert >}}
 
 ## Overview
 
 This example uses MinIO as a storage provider with Polaris.
 
 Spark is used as a query engine. This example assumes a local Spark installation.
-See the [Spark Notebooks Example](../spark/README.md) for a more advanced Spark setup.
+See the [Spark Notebooks Example](../spark) for a more advanced Spark setup.
 
 ## Starting the Example
 
@@ -43,7 +56,7 @@ See the [Spark Notebooks Example](../spark/README.md) for a more advanced Spark
 2. Start the docker compose group by running the following command from the root of the repository:
 
     ```shell
-    docker compose -f getting-started/minio/docker-compose.yml up
+    docker compose -f site/content/guides/minio/docker-compose.yml up
     ```
 
 ## Connecting From Spark
diff --git a/getting-started/ozone/docker-compose.yml b/site/content/guides/ozone/docker-compose.yml
similarity index 100%
rename from getting-started/ozone/docker-compose.yml
rename to site/content/guides/ozone/docker-compose.yml
diff --git a/getting-started/ozone/README.md b/site/content/guides/ozone/index.md
similarity index 71%
rename from getting-started/ozone/README.md
rename to site/content/guides/ozone/index.md
index f05c0b6abe..60fc5a5ef8 100644
--- a/getting-started/ozone/README.md
+++ b/site/content/guides/ozone/index.md
@@ -1,37 +1,49 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris and Apache Ozone
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Storage: Apache Ozone"
+title: "Getting Started with Apache Polaris and Apache Ozone"
+weight: 200
+tags:
+  - ozone
+  - object storage
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 200
+---
 
 ## Overview
 
 This example uses [Apache Ozone](https://ozone.apache.org/) as a storage provider with Polaris.
 
 Spark is used as a query engine. This example assumes a local Spark installation.
-See the [Spark Notebooks Example](../spark/README.md) for a more advanced Spark setup.
+See the [Spark Notebooks Example](../spark) for a more advanced Spark setup.
 
 ## Starting the Example
 
 Start the docker compose group by running the following command from the root of the repository:
 
 ```shell
-docker compose -f getting-started/ozone/docker-compose.yml up
+docker compose -f site/content/guides/ozone/docker-compose.yml up
 ```
 
 Note: this example pulls the `apache/polaris:latest` image, but assumes the image is `1.2.0-incubating` or later. 
diff --git a/getting-started/quickstart/docker-compose.yml b/site/content/guides/quickstart/docker-compose.yml
similarity index 100%
rename from getting-started/quickstart/docker-compose.yml
rename to site/content/guides/quickstart/docker-compose.yml
diff --git a/site/content/guides/quickstart/index.md b/site/content/guides/quickstart/index.md
new file mode 100644
index 0000000000..5157698117
--- /dev/null
+++ b/site/content/guides/quickstart/index.md
@@ -0,0 +1,38 @@
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Apache Polaris"
+title: "Getting Started"
+weight: 10
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 2
+---
+
+Please see the [quickstart guide](../../in-dev/unreleased/getting-started) for more information.
+
+<!--
+```shell
+cd "$SITE_TEST_GUIDE_DIR"
+docker compose up
+```
+-->
\ No newline at end of file
diff --git a/getting-started/rustfs/docker-compose.yml b/site/content/guides/rustfs/docker-compose.yml
similarity index 100%
rename from getting-started/rustfs/docker-compose.yml
rename to site/content/guides/rustfs/docker-compose.yml
diff --git a/getting-started/rustfs/README.md b/site/content/guides/rustfs/index.md
similarity index 62%
rename from getting-started/rustfs/README.md
rename to site/content/guides/rustfs/index.md
index 7b9f1728f2..7158d2d462 100644
--- a/getting-started/rustfs/README.md
+++ b/site/content/guides/rustfs/index.md
@@ -1,30 +1,46 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris and RustFS
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Storage: RustFS"
+title: "Getting Started with Apache Polaris and RustFS"
+weight: 200
+tags:
+   - rustfs
+   - object storage
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 200
+---
+
+{{< alert warning >}}
+**Disclaimer:** This guide uses mc from MinIO OSS for local testing only. MinIO OSS is in maintenance mode, and MinIO container images may no longer receive updates or security fixes. For production setups, [rc](https://github.com/rustfs/cli) should be used.
+{{< /alert >}}
 
 ## Overview
 
 This example uses [RustFS](https://rustfs.com/) as a storage provider with Polaris.
 
 Spark is used as a query engine. This example assumes a local Spark installation.
-See the [Spark Notebooks Example](../spark/README.md) for a more advanced Spark setup.
+See the [Spark Notebooks Example](../spark) for a more advanced Spark setup.
 
 ## Starting the Example
 
@@ -40,7 +56,7 @@ See the [Spark Notebooks Example](../spark/README.md) for a more advanced Spark
 2. Start the docker compose group by running the following command from the root of the repository:
 
     ```shell
-    docker compose -f getting-started/rustfs/docker-compose.yml up
+    docker compose -f site/content/guides/rustfs/docker-compose.yml up
     ```
 
 ## Connecting From Spark
diff --git a/getting-started/spark/docker-compose.yml b/site/content/guides/spark/docker-compose.yml
similarity index 91%
rename from getting-started/spark/docker-compose.yml
rename to site/content/guides/spark/docker-compose.yml
index d613e5d68c..800571d83c 100644
--- a/getting-started/spark/docker-compose.yml
+++ b/site/content/guides/spark/docker-compose.yml
@@ -40,8 +40,8 @@ services:
       retries: 5
   jupyter:
     build:
-      context: ../../ # this is necessary to expose `regtests/` dir to notebooks/Dockerfile
-      dockerfile: ./getting-started/spark/notebooks/Dockerfile
+      context: ../../../../ # this is necessary to expose `regtests/` dir to notebooks/Dockerfile
+      dockerfile: site/content/guides/spark/notebooks/Dockerfile
       network: host
     ports:
       - "8888:8888"
diff --git a/getting-started/spark/README.md b/site/content/guides/spark/index.md
similarity index 52%
rename from getting-started/spark/README.md
rename to site/content/guides/spark/index.md
index 36684859fe..85dd84eeaa 100644
--- a/getting-started/spark/README.md
+++ b/site/content/guides/spark/index.md
@@ -1,23 +1,34 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Spark and Apache Polaris
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Client: Apache Spark"
+title: "Getting Started with Apache Polaris and Apache Spark"
+tags:
+  - spark
+weight: 300
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 300
+---
 
 This getting started guide provides a `docker-compose` file to set up [Apache Spark](https://spark.apache.org/) with Apache Polaris. Apache Polaris is configured as an Iceberg REST Catalog in Spark. 
 A Jupyter notebook is used to run PySpark.
@@ -26,11 +37,17 @@ A Jupyter notebook is used to run PySpark.
 
 If a Polaris image is not already present locally, build one with the following command:
 
+<!-- Guide testing: does not work without AWS.
+```shell
+exit 0
+```
+-->
+
 ```shell
 ./gradlew \
-  :polaris-server:assemble \
-  :polaris-server:quarkusAppPartsBuild --rerun \
-  -Dquarkus.container-image.build=true
+   :polaris-server:assemble \
+   :polaris-server:quarkusAppPartsBuild --rerun \
+   -Dquarkus.container-image.build=true
 ```
 
 ## Run the `docker-compose` file
diff --git a/getting-started/spark/notebooks/Dockerfile b/site/content/guides/spark/notebooks/Dockerfile
similarity index 100%
rename from getting-started/spark/notebooks/Dockerfile
rename to site/content/guides/spark/notebooks/Dockerfile
diff --git a/getting-started/spark/notebooks/SparkPolaris.ipynb b/site/content/guides/spark/notebooks/SparkPolaris.ipynb
similarity index 100%
rename from getting-started/spark/notebooks/SparkPolaris.ipynb
rename to site/content/guides/spark/notebooks/SparkPolaris.ipynb
diff --git a/getting-started/telemetry/docker-compose.yml b/site/content/guides/telemetry/docker-compose.yml
similarity index 100%
rename from getting-started/telemetry/docker-compose.yml
rename to site/content/guides/telemetry/docker-compose.yml
diff --git a/getting-started/telemetry/README.md b/site/content/guides/telemetry/index.md
similarity index 50%
rename from getting-started/telemetry/README.md
rename to site/content/guides/telemetry/index.md
index 88fc1cbe4e..b0f684432f 100644
--- a/getting-started/telemetry/README.md
+++ b/site/content/guides/telemetry/index.md
@@ -1,23 +1,36 @@
-<!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
-
-# Getting Started with Apache Polaris, Prometheus and Jaeger
+---
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+linkTitle: "Telemetry: Prometheus and Jaeger"
+title: "Getting Started with Apache Polaris, Prometheus and Jaeger"
+weight: 100
+tags:
+   - telemetry
+   - prometheus
+   - jaeger
+cascade:
+    type: guides
+menus:
+    main:
+        parent: Guides
+        weight: 100
+---
 
 This example requires `jq` to be installed on your machine.
 
@@ -25,18 +38,18 @@ This example requires `jq` to be installed on your machine.
 
     ```shell
     ./gradlew \
-      :polaris-server:assemble \
-      :polaris-server:quarkusAppPartsBuild --rerun \
-      -Dquarkus.container-image.build=true
+       :polaris-server:assemble \
+       :polaris-server:quarkusAppPartsBuild --rerun \
+       -Dquarkus.container-image.build=true
     ```
 
 2. Start the docker compose group by running the following command from the root of the repository:
 
     ```shell
-    export ASSETS_PATH=$(pwd)/getting-started/assets/
+    export ASSETS_PATH=$(pwd)/site/content/guides/assets/
     export CLIENT_ID=root
     export CLIENT_SECRET=s3cr3t
-    docker compose -f getting-started/telemetry/docker-compose.yml up
+    docker compose -f site/content/guides/telemetry/docker-compose.yml up
     ```
 
 3. To access Polaris from the host machine, first request an access token:
diff --git a/site/hugo.yaml b/site/hugo.yaml
index 4acb68a93c..d18284ff43 100644
--- a/site/hugo.yaml
+++ b/site/hugo.yaml
@@ -131,6 +131,11 @@ menu:
       parent: "doc"
       weight: 1000
 
+    - name: "Guides"
+      identifier: "Guides"
+      url: "/guides"
+      weight: 120
+
     - name: "Tools"
       identifier: "tools"
       url: "/tools"
diff --git a/site/content/guides/_index.adoc b/site/it/.gitignore
similarity index 79%
rename from site/content/guides/_index.adoc
rename to site/it/.gitignore
index e86c6201cc..8fba71b1b8 100644
--- a/site/content/guides/_index.adoc
+++ b/site/it/.gitignore
@@ -1,4 +1,3 @@
----
 #
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
@@ -17,15 +16,6 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-linkTitle: "Guides"
-title: "Apache Polaris Guides"
-weight: 200
-cascade:
-    type: docs
-# TODO remove when adding the first proposal
-top_hidden: true
-toc_hide: true
-hide_summary: true
----
 
-= Guides
+/uv.lock
+**/__pycache__/
diff --git a/site/it/README.md b/site/it/README.md
new file mode 100644
index 0000000000..81bfe3f088
--- /dev/null
+++ b/site/it/README.md
@@ -0,0 +1,117 @@
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+
+# Polaris Guide Testing
+
+This repository contains tools and scripts for testing Apache Spark guides.
+It provides a framework for running automated tests against guide content,
+ensuring that at least the basic functionality works.
+
+## Overview
+
+Guide testing is performed via the "entry" shell script `site_guide_ci.sh`,
+which can also be invoked locally.
+
+The "entry" script calls a Python tool to extract the code blocks from a
+guide's Markdown file and write it to a temporary file as a bash script.
+Only `shell` code blocks are extracted, see [Spark SQL](#spark-sql-code) below. 
+
+The "entry" script then executes the generated bash script.
+
+Executed code blocks that do not complete successfully, stop the execution of
+the generated test script and mark the test for that guide as failed. 
+
+Each generated temporary bash script, one per guide, is called with the
+current working directory set to the projects _workspace_ directory.
+
+## Running the tests
+
+Requirements: Python 3.14
+
+To run tests for all guides in `site/content/guides`, run
+```shell
+cd site/it
+./markdown-testing.py
+```
+
+To run tests for one or more guides in `site/content/guides`, use the following pattern:
+```shell
+cd site/it
+./markdown-testing.py content/guides/rustfs/index.md content/guides/telemetry/index.md
+```
+
+## Adding assertions and test specific code
+
+"Assertions" and other executions for the guide-tests can be added to the
+Markdown file by adding a `shell` code block inside an HTML comment.
+The code block will be executed but not appear in the guide.
+
+````html
+<!--
+```shell
+# add shell script code to test things
+```
+-->
+````
+
+## Environment variables available to the generated bash scripts
+
+| Variable                  | Description                                         |
+|---------------------------|-----------------------------------------------------|
+| `SITE_TEST_WORKSPACE_DIR` | Absolute path to the project's workspace directory. |
+| `SITE_TEST_GUIDE_DIR`     | Absolute path to the guide's directory.             |
+
+## Applied `shell` code block tweaks
+
+* Many guides start Docker Compose without the [`--detach` option](https://docs.docker.com/reference/cli/docker/compose/up/).
+  The generated test code adds the `--detach --wait --quiet-pull` options to the
+  `docker compose up` command.
+* `curl` command invocations get the `--fail-with-body` option.
+  Adding either the `--fail` or `--fail-with-body` option should be considered for
+  ever usage of `curl`, otherwise `curl` will exit with code 0 for error responses
+  like 401 or 404 and others. 
+* `spark-sql` invocations get the SQL statements to execute via a file that is generated
+  from the following `sql` code blocks.
+
+## Tips
+
+See [Authoring Guides](../content/guides/_index.md#authoring-guides).
+
+
+## Spark SQL code
+
+Many guides use Spark SQL code blocks.
+The Python tool recognizes a sequence of a `shell` code block that starts with
+a line containing `bin/spark-sql` followed by one or more `sql` code blocks and
+unifies both into one execution of Spark SQL.
+
+## GitHub Workflow
+
+The GitHub workflow `site_guide_ci.yml` is used to run the guide tests on pull requests.
+
+The executed generated bash scripts and the corresponding log files are uploaded as
+GitHub workflow artifacts.
+
+## Linting
+
+Run the local lint checks with:
+
+```bash
+./lint.sh
+```
diff --git a/site/it/lint.sh b/site/it/lint.sh
new file mode 100755
index 0000000000..fca218d757
--- /dev/null
+++ b/site/it/lint.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+set -euo pipefail
+
+script_dir="$(cd -- "$(dirname "$0")" && pwd)"
+cd "${script_dir}"
+
+python3 -m ruff format .
+python3 -m ruff check --fix .
diff --git a/site/it/markdown-testing.py b/site/it/markdown-testing.py
new file mode 100755
index 0000000000..8fae026a7d
--- /dev/null
+++ b/site/it/markdown-testing.py
@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import sys
+
+from site_checks.markdown_testing import markdown_testing
+
+if __name__ == "__main__":
+    args = sys.argv[1:]
+    raise SystemExit(0 if markdown_testing(args) else 1)
diff --git a/site/it/pyproject.toml b/site/it/pyproject.toml
new file mode 100644
index 0000000000..f86c53cbb2
--- /dev/null
+++ b/site/it/pyproject.toml
@@ -0,0 +1,61 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+[project]
+name = "site-checks"
+version = "0.0.0"
+description = "Apache Polaris - Internal Site Guide Testing"
+authors = [{ name = "Apache Software Foundation", email = "dev@polaris.apache.org" }]
+license = "Apache-2.0"
+requires-python = ">=3.14"
+dependencies = [
+]
+
+[project.urls]
+homepage = "https://polaris.apache.org/"
+repository = "https://github.com/apache/polaris/"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "ruff>=0.7.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+required-version = ">=0.9.0" # keep this as the first item for version parsing
+default-groups = [
+    "dev"
+]
+
+[tool.hatch.build.targets.wheel]
+include = ["site_checks"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.pytest.ini_options]
+testpaths = ["test"]
diff --git a/site/it/site_checks/__init__.py b/site/it/site_checks/__init__.py
new file mode 100644
index 0000000000..fe95886d5c
--- /dev/null
+++ b/site/it/site_checks/__init__.py
@@ -0,0 +1,18 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
diff --git a/site/it/site_checks/code_block.py b/site/it/site_checks/code_block.py
new file mode 100644
index 0000000000..e355253067
--- /dev/null
+++ b/site/it/site_checks/code_block.py
@@ -0,0 +1,144 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import re
+from io import TextIOBase
+from typing import List, Optional
+
+docker_compose_up_pattern = re.compile("\\s*(\\bdocker[ -]compose\\b(\\s.+)?\\sup\\b)(\\s.+)?")
+# https://docs.docker.com/reference/cli/docker/compose/up/
+docker_compose_up_args = "--detach --wait --quiet-pull"
+
+spark_sql_pattern = re.compile("(.*)bin/spark-sql(.*)")
+
+curl_pattern = re.compile("(.*)\\bcurl\\b(.*)")
+
+
+def tweak_docker_compose_up(code: List[str]) -> List[str]:
+    """
+    Tweaks a `docker compose up` in a code block to have the necessary options to
+    start the containers in the background.
+    :param code: Input code block lines.
+    :return: Tweaked code block lines.
+    """
+    out: List[str] = []
+    for line in code:
+        match = docker_compose_up_pattern.match(line)
+        if match:
+            out.append(f"{match.group(1)} {docker_compose_up_args} {match.group(3) or ''}")
+        else:
+            out.append(line)
+    return out
+
+
+def tweak_spark_sql(code: List[str]) -> List[str]:
+    """
+    Tweaks a `spark-sql` command in a code block to use the local Spark installation
+    referenced via the environment variable `SPARK_SQL_BIN` during execution of the
+    generated script.
+    :param code: Input code block lines.
+    :return: Tweaked code block lines.
+    """
+    out: List[str] = []
+    for line in code:
+        match = spark_sql_pattern.match(line)
+        if match:
+            out.append(f"{match.group(1)}{'${SPARK_SQL_BIN}'}{match.group(2)}")
+        else:
+            out.append(line)
+    return out
+
+
+def tweak_curl(code: List[str]) -> List[str]:
+    out: List[str] = []
+    for line in code:
+        match = curl_pattern.match(line)
+        if match:
+            out.append(f"{match.group(1)}curl --fail-with-body{match.group(2)}")
+        else:
+            out.append(line)
+    return out
+
+
+class CodeBlockBase:
+    code_type: Optional[str]
+    start_marker: str
+    indent: int
+    code: List[str]
+    line_no: int
+    skip_all: bool
+
+    def __init__(self, line_no: int, start_marker: str, indent: int, code_type: Optional[str] = None, skip_all: bool = False):
+        self.line_no = line_no
+        self.start_marker = start_marker
+        self.indent = indent
+        self.code = []
+        self.nested_code_blocks = []
+        self.code_type = code_type
+        self.skip_all = skip_all
+
+    def code_append(self, line: str) -> None:
+        self.code.append(line[self.indent:].rstrip())
+
+    def __str__(self) -> str:
+        return (f"CodeBlock(line_no={self.line_no}, code_type={self.code_type!r}, "
+                f"skip_all={self.skip_all}, indent={self.indent}, lines={len(self.code)})")
+
+
+class CodeBlock(CodeBlockBase):
+    nested_code_blocks: List[CodeBlockBase]
+
+    def __init__(self, line_no: int, start_marker: str, indent: int, code_type: Optional[str] = None, skip_all: bool = False):
+        super().__init__(line_no, start_marker, indent, code_type, skip_all)
+        self.nested_code_blocks = []
+
+
+class CodeBlocksGlobal:
+    skipped: List[CodeBlockBase]
+
+    def __init__(self):
+        self.skipped = []
+
+    def is_skipped(self, code_block: CodeBlockBase) -> bool:
+        return any(cb.code_type == code_block.code_type and cb.code == code_block.code for cb in self.skipped)
+
+
+# noinspection SpellCheckingInspection
+def emit_code_block(f: TextIOBase, type_name: str, code: List[str], line_no: int, skipped: bool = False) -> None:
+    """
+    Emits a code block to the given file.
+    :param f: The target output.
+    :param type_name: Name of the code block type, like "shell" or "Spark SQL shell".
+    :param code: Code block lines.
+    :param line_no: Starting line number of the code block in the Markdown file.
+    """
+    f.write(f'echo "::group::Dump of {"skipped/repeated " if skipped else ""}{type_name} code block at line {line_no}"\n')
+    # Write the code block to be `echo`d so it is shown in the CI job log.
+    f.write("cat <<CODE_SNIPPET_DUMP\n")
+    for line in code:
+        line = line.replace("\\", "\\\\")
+        line = line.replace("$", "\\$")
+        f.write(line + "\n")
+    f.write("\nCODE_SNIPPET_DUMP\n")
+    f.write('echo "::endgroup::"\n')
+    if not skipped:
+        # Write the code block to be executed.
+        f.write(f'echo "::group::Execution of {type_name} code block at line {line_no}"\n')
+        f.writelines("\n".join(code))
+        f.write('\necho "::endgroup::"\n')
diff --git a/site/it/site_checks/docker.py b/site/it/site_checks/docker.py
new file mode 100644
index 0000000000..e585975c67
--- /dev/null
+++ b/site/it/site_checks/docker.py
@@ -0,0 +1,112 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import json
+import subprocess
+import time
+
+from .tee import Tee
+
+DASH_LINE = "------------------------------------------------------------------------------------------------"
+
+
+def cleanup_docker(tee: Tee) -> float:
+    """
+    Clean up (remove) Docker containers, networks, and volumes.
+
+    :param tee: Log output.
+    :return: Elapsed time (in seconds) spent running this cleanup.
+    """
+    start = time.monotonic()
+    try:
+        tee.printf("::group::Cleanup Docker containers, networks, volumes")
+        tee.printf("Purging Docker containers...")
+        try:
+            result = subprocess.run(
+                ["docker", "ps", "-a", "-q"],
+                capture_output=True,
+                text=True,
+                check=False,
+            )
+            container_ids = [line for line in result.stdout.splitlines() if line.strip()]
+            if container_ids:
+                tee.run(["docker", "container", "rm", "-f", *container_ids])
+        except FileNotFoundError:
+            pass
+        tee.printf("Purging Docker networks...")
+        try:
+            tee.run(["docker", "network", "prune", "-f"])
+        except FileNotFoundError:
+            pass
+        tee.printf("Purging Docker volumes...")
+        try:
+            tee.run(["docker", "volume", "prune", "-f"])
+        except FileNotFoundError:
+            pass
+        tee.printf("::endgroup::")
+    finally:
+        return time.monotonic() - start
+
+
+def docker_compose_info(tee: Tee, md_base_name: str, md_dir_name: str) -> float:
+    """
+    Emit docker compose status/logs for any known compose projects.
+
+    :param tee: Log output.
+    :param md_base_name: Markdown file base name (for logging/group naming).
+    :param md_dir_name: Markdown file directory name (for logging/group naming).
+    :return: Elapsed time (in seconds) spent collecting docker compose information.
+    """
+    start = time.monotonic()
+    tee.printf(f"::group::Docker Compose information for {md_base_name} in {md_dir_name}")
+    tee.printf(DASH_LINE)
+    try:
+        result = subprocess.run(
+            ["docker", "compose", "ls", "--all", "--format", "json"],
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+    except FileNotFoundError:
+        tee.printf(DASH_LINE)
+        tee.printf("::endgroup::")
+        return time.monotonic() - start
+
+    try:
+        compose_entries = json.loads(result.stdout) if result.stdout.strip() else []
+    except json.JSONDecodeError:
+        compose_entries = []
+
+    for entry in compose_entries:
+        docker_compose_file = entry.get("ConfigFiles")
+        if not docker_compose_file:
+            continue
+        tee.printf(DASH_LINE)
+        tee.printf(f"Docker compose file {docker_compose_file}")
+        tee.printf("    docker compose ps:")
+        tee.run(
+            ["docker", "compose", "-f", docker_compose_file, "ps", "--all", "--no-trunc", "--orphans"],
+        )
+        tee.printf("    docker compose logs:")
+        tee.run(
+            ["docker", "compose", "-f", docker_compose_file, "logs", "--timestamps"],
+        )
+    tee.printf(DASH_LINE)
+    tee.printf("::endgroup::")
+    return time.monotonic() - start
diff --git a/site/it/site_checks/gen_test_script.py b/site/it/site_checks/gen_test_script.py
new file mode 100644
index 0000000000..9e151b11c6
--- /dev/null
+++ b/site/it/site_checks/gen_test_script.py
@@ -0,0 +1,179 @@
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing,
+#  software distributed under the License is distributed on an
+#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+#  specific language governing permissions and limitations
+#  under the License.
+
+# Transforms a Markdown file into a bash script that can be used to test a guide.
+# An `sql` code block preceded by a `shell` code block is transformed into a `sqlshell`
+# code block if the first line of the `shell` code block contains `bin/spark-sql`.
+
+# "Assertions" and other executions for the guide-tests can be added to the
+# Markdown file by adding a `shell` code block inside an HTML comment.
+# The code block will be executed but not appear in the guide.
+#
+# <!--
+# ```shell
+# # add shell script code to test things
+# ```
+# -->
+
+# Markdown code blocks are opened with _at least_ 3 backtick,
+# optionally preceded by whitespaces,
+# optionally followed by a language identifier.
+# Must check that the close marker is the same as the open marker,
+# excluding the language identifier.
+#
+# "Normal" code block example:
+# ```shell
+# some-shell-code
+# ```
+#
+# Indented code block example:
+#     ```shell
+#     some-shell-code
+#     ```
+#
+# A code block that includes 3 backticks can be written as:
+# ````shell
+# some-shell-code - the backticks are part of the code block!
+# ```
+# ````
+#
+
+import re
+from os import chmod
+from pathlib import Path
+from textwrap import dedent
+from typing import List, Optional
+
+from .code_block import CodeBlock, CodeBlocksGlobal, \
+    emit_code_block, tweak_curl, tweak_docker_compose_up, tweak_spark_sql
+
+open_pattern = re.compile("((\\s*)`{3,})([a-z0-9-_:]+)?\\s*(\\bskip_all\\b)?\\s*")
+close_pattern = re.compile("(\\s*`{3,})")
+
+
+def generate_markdown_test_script(markdown_file: Path, output_file: Path, code_blocks_global: CodeBlocksGlobal) -> None:
+    """
+    Parses a Markdown file and generates a bash script that can be used to test a guide.
+
+    Constraints:
+    1. `docker compose` invocations must be on a single line in a `shell` code block.
+    2. Spark SQL shell invocations must be the only statement `shell` code block in a guide.
+
+    :param markdown_file: The Markdown file to process.
+    :param output_file: The output bash script file to generate.
+    :param code_blocks_global: Global state for code blocks, including skipped blocks.
+    """
+    code_blocks: List[CodeBlock] = []
+    with open(markdown_file) as f:
+        code_block: Optional[CodeBlock] = None
+        line_no = 1
+        for line in f.readlines():
+            if not code_block:
+                open_match = re.match(open_pattern, line)
+                if open_match is not None:
+                    code_block = CodeBlock(
+                        line_no=line_no,
+                        start_marker=open_match.group(1),
+                        indent=len(open_match.group(2)),
+                        code_type=open_match.group(3),
+                        skip_all=open_match.group(4) is not None
+                    )
+            else:
+                close_match = re.match(close_pattern, line)
+                if close_match and close_match.group(1) == code_block.start_marker:
+                    num_code_blocks = len(code_blocks)
+                    if num_code_blocks > 0:
+                        prev_code_block = code_blocks[num_code_blocks - 1]
+                        if code_block.code_type == "sql" and (
+                            (
+                                prev_code_block.code_type == "shell"
+                                and len(prev_code_block.code) > 0
+                                and "bin/spark-sql" in prev_code_block.code[0]
+                            )
+                            or prev_code_block.code_type == "sqlshell"
+                        ):
+                            prev_code_block.code_type = "sqlshell"
+                            prev_code_block.nested_code_blocks.append(code_block)
+                        else:
+                            code_blocks.append(code_block)
+                    else:
+                        code_blocks.append(code_block)
+                    code_block = None
+                else:
+                    line = line.rstrip()
+                    if len(code_block.code) > 0 or len(line) > 0:
+                        code_block.code_append(line)
+            line_no += 1
+
+    with open(output_file, mode="wt") as f:
+        f.write("#!/usr/bin/env bash\n")
+        f.write("set -e\n")
+        f.write("set -o pipefail\n")
+        f.write(
+            dedent(f"""
+             #
+             # Code blocks from markdown source: {markdown_file}
+             ##################################################################
+             #
+             """)
+        )
+        for code_block in code_blocks:
+            f.write(
+                dedent(f"""
+                 #
+                 # Code block type: {code_block.code_type}
+                 # Line number in markdown: {code_block.line_no}
+                 ##################################################################
+                 #
+                 """)
+            )
+            if len(code_block.code) == 0:
+                f.write("# Code block is empty\n")
+                continue
+
+            if not code_block.code_type:
+                continue
+
+            if code_block.skip_all:
+                code_blocks_global.skipped.append(code_block)
+            elif code_block.code_type == "shell":
+                code = tweak_docker_compose_up(code_block.code)
+                code = tweak_curl(code)
+                code = tweak_spark_sql(code)
+                emit_code_block(f=f, type_name="shell", code=code, line_no=code_block.line_no,
+                                skipped=code_blocks_global.is_skipped(code_block))
+            elif code_block.code_type == "sqlshell":
+                sql_code: List[str] = ['cat > "${BUILD_TESTS_DIR}/.current.sql" <<SQL_SNIPPET_EOF']
+                for nested_code_block in code_block.nested_code_blocks:
+                    sql_code.append("-------------------------------------------------------------------")
+                    sql_code.append(f"-- SQL code block starting at line {nested_code_block.line_no}")
+                    sql_code += nested_code_block.code
+                sql_code.append("SQL_SNIPPET_EOF")
+                emit_code_block(f=f, type_name="Write SQL file for", code=sql_code, line_no=code_block.line_no)
+
+                code = tweak_spark_sql(code_block.code)
+                combined_code: List[str] = []
+                combined_code += code[:-1]
+                last_code_line = code[-1]
+                combined_code.append(last_code_line + " \\")
+                combined_code.append(' -f "${BUILD_TESTS_DIR}/.current.sql"')
+                combined_code.append('rm -f "${BUILD_TESTS_DIR}/.current.sql"')
+                emit_code_block(f=f, type_name="Spark SQL shell", code=combined_code, line_no=code_block.line_no)
+            else:
+                f.writelines("\n".join([f"# {line}" for line in code_block.code]))
+                f.write("\n")
+    chmod(output_file, 0o755)
diff --git a/site/it/site_checks/markdown_testing.py b/site/it/site_checks/markdown_testing.py
new file mode 100644
index 0000000000..416fc3017e
--- /dev/null
+++ b/site/it/site_checks/markdown_testing.py
@@ -0,0 +1,240 @@
+#!/usr/bin/env python3
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from __future__ import annotations
+
+import getopt
+import os
+import sys
+import time
+from pathlib import Path
+from textwrap import dedent
+from typing import List
+
+from .code_block import CodeBlocksGlobal
+from .docker import cleanup_docker, docker_compose_info
+from .gen_test_script import generate_markdown_test_script
+from .spark import SPARK_TGZ_URL, ensure_spark
+from .tee import Tee
+
+
+def _format_duration(seconds: float) -> str:
+    seconds = max(0.0, float(seconds))
+    if seconds < 60:
+        return f"{seconds:.2f}s"
+    minutes = int(seconds // 60)
+    rem_seconds = int(round(seconds - (minutes * 60)))
+    if rem_seconds == 60:
+        minutes += 1
+        rem_seconds = 0
+    return f"{minutes}m {rem_seconds:02d}s"
+
+
+def run_test(
+    md_file: Path,
+    site_dir: Path,
+    workspace_dir: Path,
+    build_tests_dir: Path,
+    test_summary_file: Path,
+    env: dict[str, str],
+    code_blocks_global: CodeBlocksGlobal
+) -> bool:
+    """
+    Exercises testing of a single Markdown file.
+
+    :param md_file: The Markdown file to test.
+    :param site_dir: The `site/` directory of the workspace.
+    :param workspace_dir: Root of the Polaris worktree directory.
+    :param build_tests_dir: Directory to place test scripts and logs.
+    :param test_summary_file: Summary file for the test results.
+    :param env: Environment variables to pass to the test script.
+    :return: `True` if the test ran successfully, `False` otherwise.
+    """
+    if not md_file.is_file():
+        raise Exception(f"Error: {md_file} does not exist or is not a file")
+    if md_file.suffix != ".md":
+        raise Exception(f"Error: {md_file} is not a markdown file")
+
+    try:
+        md_rel_path = md_file.resolve().relative_to(site_dir.resolve())
+    except ValueError:
+        raise Exception(f"Error: {md_file} must be inside {site_dir}")
+
+    md_rel_name = md_rel_path.as_posix()
+    md_base_name = md_file.name
+    md_dir_name = str(md_rel_path.parent)
+    test_name = md_rel_name.replace("/", "_-_")
+    test_script = build_tests_dir / f"{test_name}.sh"
+    log_file = build_tests_dir / f"{test_name}.log"
+
+    with log_file.open("w", encoding="utf-8") as log_handle:
+        tee = Tee(sys.stdout, log_handle)
+        tee.printf(">")
+        tee.printf(f"> Testing {md_base_name} in {md_dir_name} ...")
+
+        generate_markdown_test_script(md_file, test_script, code_blocks_global)
+
+        cleanup_docker(tee)
+        env = dict(env)
+        env["SITE_TEST_GUIDE_DIR"] = str(site_dir / md_dir_name)
+        test_start = time.monotonic()
+        failed = tee.run([str(test_script)], cwd=workspace_dir, env=env) != 0
+        test_duration = time.monotonic() - test_start
+        # Unconditionally emit an `::endgroup::` in case the generated script failed to emit its own.
+        tee.printf("::endgroup::")
+
+        duration_str = _format_duration(test_duration)
+        if failed:
+            summary = f"❌ Test failed for {md_file} ({duration_str})"
+        else:
+            summary = f"✅ Test passed for {md_file} ({duration_str})"
+
+        tee.printf(f"{summary}")
+        with test_summary_file.open("a", encoding="utf-8") as summary_handle:
+            summary_handle.write(f"{summary}\n")
+        if env.get("GITHUB_STEP_SUMMARY"):
+            with open(env["GITHUB_STEP_SUMMARY"], "a", encoding="utf-8") as summary_out:
+                summary_out.write(f"{summary}\n")
+        tee.printf(">")
+
+        docker_info_duration = docker_compose_info(tee, md_base_name, md_dir_name)
+        cleanup_duration = cleanup_docker(tee)
+
+        tee.printf(dedent(f"""
+            Test steps durations for for {md_file} ({'❌ FAILED' if failed else '✅ passed'}):
+                .. Test: {duration_str}
+                .. Docker Compose Info: {_format_duration(docker_info_duration)}
+                .. Docker Cleanup: {_format_duration(cleanup_duration)}
+            """))
+        tee.printf("************************************************************************************************")
+
+    return not failed
+
+
+def usage() -> None:
+    sys.stderr.write(
+        dedent(
+            f"""
+        Usage: markdown-testing.sh [options] [<markdown-file> ...]
+
+        markdown-files MUST be inside the site/ directory.
+        If no markdown-files are specified on the command line,
+        all markdown-files in site/content/guides are tested.
+
+        Options:
+          -s <spark-tarball>
+          --spark-tarball=<spark-tarball>
+               URL to download the Spark tarball.
+               Default: {SPARK_TGZ_URL}.
+          -S
+          --download-spark-tarball
+               Always download the Spark tarball.
+          -h
+          --help  
+               Show this help text.
+        """
+        )
+    )
+
+
+def markdown_testing(args: List[str]) -> bool:
+    """
+    Main entry point for Markdown code block testing.
+
+    :param args: Command line arguments.
+    :return: `False` indicates an error occurred, `True` otherwise.
+    """
+    try:
+        opts, args = getopt.getopt(args, "hs:S", ["help", "spark-tarball=", "download-spark-tarball"])
+    except getopt.GetoptError as exc:
+        sys.stderr.write(f"Unknown option: -{exc.opt}\n")
+        usage()
+        return False
+
+    spark_tarball_url = SPARK_TGZ_URL
+    spark_download_requested = False
+
+    for opt, val in opts:
+        if opt in ("-h", "--help"):
+            usage()
+            return True
+        elif opt in ("-s", "--spark-spark_tarball"):
+            spark_tarball_url = val
+        elif opt in ("-S", "--download-spark-tarball"):
+            spark_download_requested = True
+
+    script_dir = Path(__file__).resolve().parent.parent
+    site_dir = script_dir.parent
+
+    build_dir = site_dir / "it" / "build"
+    build_tests_dir = build_dir / "tests"
+    spark_dir = build_dir / "spark"
+    build_tests_dir.mkdir(parents=True, exist_ok=True)
+    spark_dir.mkdir(parents=True, exist_ok=True)
+
+    spark_sql_bin = spark_dir / "bin" / "spark-sql"
+    ensure_spark(
+        spark_sql_bin=spark_sql_bin,
+        spark_dir=spark_dir,
+        spark_tarball_url=spark_tarball_url,
+        spark_download_requested=spark_download_requested,
+    )
+
+    workspace_dir = (site_dir / "..").resolve()
+
+    env = dict(os.environ)
+    env["SITE_TEST_WORKSPACE_DIR"] = str(workspace_dir)
+    env["SPARK_SQL_BIN"] = str(spark_sql_bin)
+    env["BUILD_TESTS_DIR"] = str(build_tests_dir)
+
+    if args:
+        raw_files = list(Path(arg) for arg in args)
+    else:
+        raw_files = (site_dir / "content" / "guides").glob("*/*.md")
+    md_files = sorted(p.absolute().relative_to(site_dir) for p in raw_files)
+
+    test_summary_file = build_tests_dir / "test-summary.txt"
+    if test_summary_file.exists():
+        test_summary_file.unlink()
+    test_summary_file.touch()
+
+    code_blocks_global = CodeBlocksGlobal()
+
+    os.chdir(site_dir)
+    all_successful = True
+    for md_file in md_files:
+        all_successful &= run_test(
+            md_file=md_file,
+            site_dir=site_dir,
+            workspace_dir=workspace_dir,
+            build_tests_dir=build_tests_dir,
+            test_summary_file=test_summary_file,
+            env=env,
+            code_blocks_global=code_blocks_global,
+        )
+
+    print(">")
+
+    print("************************************************************************************************")
+    print("Test summary:")
+    with test_summary_file.open(encoding="utf-8") as summary_handle:
+        sys.stdout.write(summary_handle.read())
+
+    return all_successful
diff --git a/site/it/site_checks/spark.py b/site/it/site_checks/spark.py
new file mode 100644
index 0000000000..a64b168f05
--- /dev/null
+++ b/site/it/site_checks/spark.py
@@ -0,0 +1,63 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import subprocess
+from pathlib import Path
+
+SPARK_TGZ_URL = "https://downloads.apache.org/spark/spark-3.5.8/spark-3.5.8-bin-hadoop3.tgz"
+
+
+def ensure_spark(
+    spark_sql_bin: Path, spark_dir: Path, spark_tarball_url: str, spark_download_requested: bool = False
+) -> None:
+    """
+    Ensure that Spark is installed.
+
+    :param spark_sql_bin: The `spark-sql` binary (must be within `spark_dir`).
+    :param spark_dir: Location of the Spark installation.
+    :param spark_tarball_url: The URL of the Spark tarball to download.
+    :param spark_download_requested: Flag indicating whether a download should always be performed.
+    """
+    print("::group::Check for Spark installation")
+    if not spark_download_requested and spark_sql_bin.exists():
+        print(f"Spark binary {spark_sql_bin} is present")
+        print("::endgroup::")
+        return
+    print(
+        f"Spark binary {spark_sql_bin} is not present or download has been explicitly requested, "
+        f"downloading from {spark_tarball_url}..."
+    )
+    curl_cmd = ["curl", "--location", spark_tarball_url]
+    tar_cmd = [
+        "tar",
+        "--extract",
+        "--gunzip",
+        "--directory",
+        str(spark_dir),
+        "--strip-components=1",
+    ]
+    with subprocess.Popen(curl_cmd, stdout=subprocess.PIPE) as curl_proc:
+        with subprocess.Popen(tar_cmd, stdin=curl_proc.stdout) as tar_proc:
+            assert curl_proc.stdout is not None
+            curl_proc.stdout.close()
+            tar_rc = tar_proc.wait()
+        curl_rc = curl_proc.wait()
+    if curl_rc != 0 or tar_rc != 0:
+        raise subprocess.CalledProcessError(curl_rc or tar_rc, curl_cmd)
+    print("::endgroup::")
diff --git a/site/it/site_checks/tee.py b/site/it/site_checks/tee.py
new file mode 100644
index 0000000000..f5d37473e3
--- /dev/null
+++ b/site/it/site_checks/tee.py
@@ -0,0 +1,63 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import subprocess
+from pathlib import Path
+from typing import Iterable, Optional
+
+
+class Tee:
+    def __init__(self, *files) -> None:
+        self._files = files
+
+    def write(self, data: str) -> None:
+        for f in self._files:
+            f.write(data)
+            f.flush()
+
+    def flush(self) -> None:
+        for f in self._files:
+            f.flush()
+
+    def run(
+        self,
+        cmd: Iterable[str],
+        cwd: Optional[Path] = None,
+        env: Optional[dict[str, str]] = None,
+        check: bool = False,
+    ) -> int:
+        proc = subprocess.Popen(
+            list(cmd),
+            cwd=str(cwd) if cwd else None,
+            env=env,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+        )
+        assert proc.stdout is not None
+        for line in proc.stdout:
+            self.write(line)
+        proc.stdout.close()
+        rc = proc.wait()
+        if check and rc != 0:
+            raise subprocess.CalledProcessError(rc, list(cmd))
+        return rc
+
+    def printf(self, *args: object) -> None:
+        print(*args, file=self, flush=True)
diff --git a/site/it/test/test_code_block.py b/site/it/test/test_code_block.py
new file mode 100644
index 0000000000..4c03fbb9b0
--- /dev/null
+++ b/site/it/test/test_code_block.py
@@ -0,0 +1,141 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from io import StringIO
+
+from site_checks.code_block import (
+    CodeBlock,
+    CodeBlockBase,
+    emit_code_block,
+    tweak_curl,
+    tweak_docker_compose_up,
+    tweak_spark_sql,
+)
+
+
+def test_code_block_base_initializes_fields() -> None:
+    block = CodeBlockBase(line_no=3, start_marker="```", indent=0, code_type="shell")
+
+    assert block.line_no == 3
+    assert block.start_marker == "```"
+    assert block.code_type == "shell"
+    assert block.code == []
+    assert block.nested_code_blocks == []
+
+
+def test_code_block_initializes_nested_blocks() -> None:
+    block = CodeBlock(line_no=8, start_marker="```sql", indent=0, code_type=None)
+
+    assert block.line_no == 8
+    assert block.start_marker == "```sql"
+    assert block.code_type is None
+    assert block.code == []
+    assert block.nested_code_blocks == []
+
+
+def test_emit_code_block_writes_dump_and_execution_sections() -> None:
+    output = StringIO()
+    code = ["echo $HOME", r"path\to\file", "plain"]
+
+    emit_code_block(output, "shell", code, line_no=12)
+
+    expected = "".join(
+        [
+            'echo "::group::Dump of shell code block at line 12"\n',
+            "cat <<CODE_SNIPPET_DUMP\n",
+            "echo \\$HOME\n",
+            "path\\\\to\\\\file\n",
+            "plain\n",
+            "\nCODE_SNIPPET_DUMP\n",
+            'echo "::endgroup::"\n',
+            'echo "::group::Execution of shell code block at line 12"\n',
+            "echo $HOME\n",
+            r"path\to\file",
+            "\nplain\n",
+            'echo "::endgroup::"\n',
+        ]
+    )
+
+    assert output.getvalue() == expected
+
+
+def test_tweak_docker_compose_up_adds_args() -> None:
+    code = [
+        "docker compose up",
+        "docker compose up --build",
+        "docker-compose -f docker-compose.yml up",
+    ]
+
+    assert tweak_docker_compose_up(code) == [
+        "docker compose up --detach --wait --quiet-pull ",
+        "docker compose up --detach --wait --quiet-pull  --build",
+        "docker-compose -f docker-compose.yml up --detach --wait --quiet-pull ",
+    ]
+
+
+def test_tweak_docker_compose_up_leaves_non_matches() -> None:
+    code = [
+        "echo docker compose up",
+        "docker ps",
+    ]
+
+    assert tweak_docker_compose_up(code) == code
+
+
+def test_tweak_spark_sql_rewrites_binary() -> None:
+    code = [
+        "bin/spark-sql --foo",
+        "  /opt/spark/bin/spark-sql -e 'select 1'",
+    ]
+
+    assert tweak_spark_sql(code) == [
+        "${SPARK_SQL_BIN} --foo",
+        "  /opt/spark/${SPARK_SQL_BIN} -e 'select 1'",
+    ]
+
+
+def test_tweak_spark_sql_leaves_non_matches() -> None:
+    code = ["echo spark-sql", "bin/spark", "spark-sql"]
+
+    assert tweak_spark_sql(code) == code
+
+
+# noinspection HttpUrlsUsage
+def test_tweak_curl_adds_fail_with_body() -> None:
+    code = [
+        "curl http://example.com",
+        "  curl -X POST http://example.com",
+        "/usr/bin/curl --head http://example.com",
+    ]
+
+    assert tweak_curl(code) == [
+        "curl --fail-with-body http://example.com",
+        "  curl --fail-with-body -X POST http://example.com",
+        "/usr/bin/curl --fail-with-body --head http://example.com",
+    ]
+
+
+# noinspection HttpUrlsUsage
+def test_tweak_curl_leaves_non_matches() -> None:
+    code = [
+        "echo curling",
+        "scurl http://example.com",
+    ]
+
+    assert tweak_curl(code) == code
diff --git a/site/it/test/test_docker.py b/site/it/test/test_docker.py
new file mode 100644
index 0000000000..f03e4d920e
--- /dev/null
+++ b/site/it/test/test_docker.py
@@ -0,0 +1,145 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from types import SimpleNamespace
+from unittest.mock import patch
+
+from site_checks.docker import cleanup_docker, docker_compose_info
+from site_checks.tee import Tee
+
+
+class TeeRecorder(Tee):
+    def __init__(self, *files) -> None:
+        super().__init__(*files)
+        self.printf_calls = []
+        self.run_calls = []
+
+    def printf(self, *args: object) -> None:
+        self.printf_calls.append(" ".join(str(arg) for arg in args))
+
+    def run(self, cmd, **kwargs) -> int:
+        self.run_calls.append((list(cmd), kwargs))
+        return 0
+
+
+class TeeRaiser(TeeRecorder):
+    def run(self, cmd, **kwargs) -> int:
+        self.run_calls.append((list(cmd), kwargs))
+        raise FileNotFoundError
+
+
+def test_cleanup_docker_removes_containers_and_prunes() -> None:
+    tee = TeeRecorder()
+    result = SimpleNamespace(stdout="abc\n\nxyz\n")
+
+    with patch("site_checks.docker.subprocess.run", return_value=result) as run_mock:
+        cleanup_docker(tee)
+
+    run_mock.assert_called_once_with(
+        ["docker", "ps", "-a", "-q"],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert tee.run_calls == [
+        (["docker", "container", "rm", "-f", "abc", "xyz"], {}),
+        (["docker", "network", "prune", "-f"], {}),
+        (["docker", "volume", "prune", "-f"], {}),
+    ]
+
+
+def test_cleanup_docker_handles_missing_docker_binary() -> None:
+    tee = TeeRaiser()
+
+    with patch("site_checks.docker.subprocess.run", side_effect=FileNotFoundError):
+        cleanup_docker(tee)
+
+    assert tee.run_calls == [
+        (["docker", "network", "prune", "-f"], {}),
+        (["docker", "volume", "prune", "-f"], {}),
+    ]
+
+
+def test_docker_compose_info_logs_entries() -> None:
+    tee = TeeRecorder()
+    result = SimpleNamespace(stdout='[{"ConfigFiles":"compose-a.yml"},{"ConfigFiles":"compose-b.yml"}]')
+
+    with patch("site_checks.docker.subprocess.run", return_value=result):
+        docker_compose_info(tee, "readme", "docs")
+
+    assert tee.run_calls == [
+        (
+            [
+                "docker",
+                "compose",
+                "-f",
+                "compose-a.yml",
+                "ps",
+                "--all",
+                "--no-trunc",
+                "--orphans",
+            ],
+            {},
+        ),
+        (
+            [
+                "docker",
+                "compose",
+                "-f",
+                "compose-a.yml",
+                "logs",
+                "--timestamps",
+            ],
+            {},
+        ),
+        (
+            [
+                "docker",
+                "compose",
+                "-f",
+                "compose-b.yml",
+                "ps",
+                "--all",
+                "--no-trunc",
+                "--orphans",
+            ],
+            {},
+        ),
+        (
+            [
+                "docker",
+                "compose",
+                "-f",
+                "compose-b.yml",
+                "logs",
+                "--timestamps",
+            ],
+            {},
+        ),
+    ]
+
+
+def test_docker_compose_info_ignores_invalid_json() -> None:
+    tee = TeeRecorder()
+    result = SimpleNamespace(stdout="not-json")
+
+    with patch("site_checks.docker.subprocess.run", return_value=result):
+        docker_compose_info(tee, "readme", "docs")
+
+    assert tee.run_calls == []
diff --git a/site/it/test/test_gen_test_script.py b/site/it/test/test_gen_test_script.py
new file mode 100644
index 0000000000..baee25128c
--- /dev/null
+++ b/site/it/test/test_gen_test_script.py
@@ -0,0 +1,99 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from pathlib import Path
+from textwrap import dedent
+
+from site_checks.code_block import CodeBlocksGlobal
+from site_checks.gen_test_script import generate_markdown_test_script
+
+
+def test_generate_markdown_test_script_tweaks_shell(tmp_path: Path) -> None:
+    markdown = tmp_path / "guide.md"
+    output = tmp_path / "guide.sh"
+
+    markdown.write_text(
+        dedent(
+            """
+        # Guide
+        ```shell
+        docker compose up
+        bin/spark-sql -e 'select 1'
+        ```
+        """
+        ),
+        encoding="utf-8",
+    )
+
+    generate_markdown_test_script(markdown, output, CodeBlocksGlobal())
+
+    script = output.read_text(encoding="utf-8")
+    assert "Code block type: shell" in script
+    assert "Line number in markdown: 3" in script
+    assert "docker compose up --detach --wait " in script
+    assert "${SPARK_SQL_BIN} -e 'select 1'" in script
+    assert output.stat().st_mode & 0o111
+
+
+def test_generate_markdown_test_script_merges_sqlshell(tmp_path: Path) -> None:
+    markdown = tmp_path / "guide.md"
+    output = tmp_path / "guide.sh"
+
+    markdown.write_text(
+        dedent(
+            """
+        ```shell
+        bin/spark-sql -e 'select 1'
+        ```
+        ```sql
+        select 1;
+        ```
+        """
+        ),
+        encoding="utf-8",
+    )
+
+    generate_markdown_test_script(markdown, output, CodeBlocksGlobal())
+
+    script = output.read_text(encoding="utf-8")
+    assert "Code block type: sqlshell" in script
+    assert "Write SQL file for" in script
+    assert "-- SQL code block starting at line 5" in script
+    assert "select 1;" in script
+    assert "${SPARK_SQL_BIN} -e 'select 1' \\\n -f \"${BUILD_TESTS_DIR}/.current.sql\"" in script
+
+
+def test_generate_markdown_test_script_handles_empty_block(tmp_path: Path) -> None:
+    markdown = tmp_path / "guide.md"
+    output = tmp_path / "guide.sh"
+
+    markdown.write_text(
+        dedent(
+            """
+        ```shell
+        ```
+        """
+        ),
+        encoding="utf-8",
+    )
+
+    generate_markdown_test_script(markdown, output, CodeBlocksGlobal())
+
+    script = output.read_text(encoding="utf-8")
+    assert "# Code block is empty" in script
diff --git a/site/it/test/test_markdown_testing.py b/site/it/test/test_markdown_testing.py
new file mode 100644
index 0000000000..340f09e70e
--- /dev/null
+++ b/site/it/test/test_markdown_testing.py
@@ -0,0 +1,158 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from pathlib import Path
+from unittest.mock import patch
+
+import pytest
+
+from site_checks import markdown_testing
+from site_checks.code_block import CodeBlocksGlobal
+
+
+class FakeTee:
+    run_return = 0
+    last_instance = None
+
+    # noinspection PyUnusedLocal
+    def __init__(self, *files) -> None:
+        FakeTee.last_instance = self
+        self.printf_calls = []
+        self.run_calls = []
+
+    def printf(self, *args: object) -> None:
+        self.printf_calls.append(" ".join(str(arg) for arg in args))
+
+    def run(self, cmd, **kwargs) -> int:
+        self.run_calls.append((list(cmd), kwargs))
+        return self.run_return
+
+
+def _fake_generate_markdown_test_script(_md_file, output_file, code_blocks_global) -> None:
+    Path(output_file).write_text("#!/usr/bin/env bash\n", encoding="utf-8")
+
+
+def test_run_test_success_writes_summary_and_env(tmp_path: Path) -> None:
+    site_dir = tmp_path / "site"
+    workspace_dir = tmp_path / "workspace"
+    build_tests_dir = tmp_path / "build-tests"
+    md_file = site_dir / "content" / "guides" / "intro" / "guide.md"
+    test_summary_file = build_tests_dir / "test-summary.txt"
+    github_summary = tmp_path / "github-summary.txt"
+
+    md_file.parent.mkdir(parents=True)
+    build_tests_dir.mkdir(parents=True)
+    md_file.write_text("# Guide\n", encoding="utf-8")
+
+    env = {"GITHUB_STEP_SUMMARY": str(github_summary)}
+
+    FakeTee.run_return = 0
+    with (
+        patch("site_checks.markdown_testing.Tee", FakeTee),
+        patch("site_checks.markdown_testing.generate_markdown_test_script", _fake_generate_markdown_test_script),
+        patch("site_checks.markdown_testing.cleanup_docker") as cleanup_mock,
+        patch("site_checks.markdown_testing.docker_compose_info") as docker_info_mock,
+    ):
+        result = markdown_testing.run_test(
+            md_file=md_file,
+            site_dir=site_dir,
+            workspace_dir=workspace_dir,
+            build_tests_dir=build_tests_dir,
+            test_summary_file=test_summary_file,
+            env=env,
+            code_blocks_global=CodeBlocksGlobal(),
+        )
+
+    assert result is True
+    assert f"✅ Test passed for {md_file}" in test_summary_file.read_text(encoding="utf-8")
+    assert f"✅ Test passed for {md_file}" in github_summary.read_text(encoding="utf-8")
+    cleanup_mock.assert_called()
+    docker_info_mock.assert_called_once()
+    assert FakeTee.last_instance is not None
+    run_env = FakeTee.last_instance.run_calls[0][1]["env"]
+    assert run_env["SITE_TEST_GUIDE_DIR"] == str(site_dir / "content" / "guides" / "intro")
+
+
+def test_run_test_failure_marks_summary(tmp_path: Path) -> None:
+    site_dir = tmp_path / "site"
+    workspace_dir = tmp_path / "workspace"
+    build_tests_dir = tmp_path / "build-tests"
+    md_file = site_dir / "content" / "guides" / "intro" / "guide.md"
+    test_summary_file = build_tests_dir / "test-summary.txt"
+
+    md_file.parent.mkdir(parents=True)
+    build_tests_dir.mkdir(parents=True)
+    md_file.write_text("# Guide\n", encoding="utf-8")
+
+    env = {}
+
+    FakeTee.run_return = 1
+    with (
+        patch("site_checks.markdown_testing.Tee", FakeTee),
+        patch("site_checks.markdown_testing.generate_markdown_test_script", _fake_generate_markdown_test_script),
+        patch("site_checks.markdown_testing.cleanup_docker"),
+        patch("site_checks.markdown_testing.docker_compose_info"),
+    ):
+        result = markdown_testing.run_test(
+            md_file=md_file,
+            site_dir=site_dir,
+            workspace_dir=workspace_dir,
+            build_tests_dir=build_tests_dir,
+            test_summary_file=test_summary_file,
+            env=env,
+            code_blocks_global=CodeBlocksGlobal(),
+        )
+
+    assert result is False
+    assert "Test failed for" in test_summary_file.read_text(encoding="utf-8")
+    assert FakeTee.last_instance is not None
+    assert "::endgroup::" in FakeTee.last_instance.printf_calls
+
+
+def test_run_test_rejects_non_markdown(tmp_path: Path) -> None:
+    site_dir = tmp_path / "site"
+    md_file = site_dir / "content" / "guides" / "intro" / "guide.txt"
+
+    md_file.parent.mkdir(parents=True)
+    md_file.write_text("not markdown", encoding="utf-8")
+
+    with pytest.raises(Exception, match="not a markdown file"):
+        markdown_testing.run_test(
+            md_file=md_file,
+            site_dir=site_dir,
+            workspace_dir=tmp_path,
+            build_tests_dir=tmp_path,
+            test_summary_file=tmp_path / "summary.txt",
+            env={},
+            code_blocks_global=CodeBlocksGlobal(),
+        )
+
+
+def test_markdown_testing_help_calls_usage() -> None:
+    with patch("site_checks.markdown_testing.usage") as usage_mock:
+        assert markdown_testing.markdown_testing(["-h"]) is True
+
+    usage_mock.assert_called_once()
+
+
+def test_markdown_testing_unknown_option_reports_error(capsys: pytest.CaptureFixture[str]) -> None:
+    assert markdown_testing.markdown_testing(["--nope"]) is False
+
+    captured = capsys.readouterr()
+    assert "Unknown option" in captured.err
diff --git a/site/it/test/test_spark.py b/site/it/test/test_spark.py
new file mode 100644
index 0000000000..ba1cf4e862
--- /dev/null
+++ b/site/it/test/test_spark.py
@@ -0,0 +1,108 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import subprocess
+from pathlib import Path
+from unittest.mock import patch
+
+import pytest
+
+from site_checks.spark import ensure_spark
+
+
+class FakeStdout:
+    def __init__(self) -> None:
+        self.closed = False
+
+    def close(self) -> None:
+        self.closed = True
+
+
+class FakeProc:
+    def __init__(self, rc: int, stdout: FakeStdout | None = None) -> None:
+        self._rc = rc
+        self.stdout = stdout
+        self.wait_calls = 0
+
+    def wait(self) -> int:
+        self.wait_calls += 1
+        return self._rc
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> bool:
+        return False
+
+
+def test_ensure_spark_skips_download_when_present() -> None:
+    spark_sql_bin = Path("/fake/spark/bin/spark-sql")
+
+    with (
+        patch("site_checks.spark.Path.exists", return_value=True),
+        patch("site_checks.spark.subprocess.Popen") as popen_mock,
+    ):
+        ensure_spark(spark_sql_bin, Path("/fake/spark"), "http://example")
+
+    popen_mock.assert_not_called()
+
+
+def test_ensure_spark_downloads_and_extracts() -> None:
+    spark_sql_bin = Path("/fake/spark/bin/spark-sql")
+    curl_stdout = FakeStdout()
+    curl_proc = FakeProc(0, stdout=curl_stdout)
+    tar_proc = FakeProc(0)
+
+    with (
+        patch("site_checks.spark.Path.exists", return_value=False),
+        patch("site_checks.spark.subprocess.Popen", side_effect=[curl_proc, tar_proc]) as popen_mock,
+    ):
+        ensure_spark(spark_sql_bin, Path("/fake/spark"), "http://example")
+
+    popen_mock.assert_any_call(["curl", "--location", "http://example"], stdout=subprocess.PIPE)
+    popen_mock.assert_any_call(
+        [
+            "tar",
+            "--extract",
+            "--gunzip",
+            "--directory",
+            "/fake/spark",
+            "--strip-components=1",
+        ],
+        stdin=curl_proc.stdout,
+    )
+    assert curl_stdout.closed is True
+    assert curl_proc.wait_calls == 1
+    assert tar_proc.wait_calls == 1
+
+
+def test_ensure_spark_raises_when_download_fails() -> None:
+    spark_sql_bin = Path("/fake/spark/bin/spark-sql")
+    curl_stdout = FakeStdout()
+    curl_proc = FakeProc(0, stdout=curl_stdout)
+    tar_proc = FakeProc(2)
+
+    with (
+        patch("site_checks.spark.Path.exists", return_value=False),
+        patch("site_checks.spark.subprocess.Popen", side_effect=[curl_proc, tar_proc]),
+    ):
+        with pytest.raises(subprocess.CalledProcessError) as excinfo:
+            ensure_spark(spark_sql_bin, Path("/fake/spark"), "http://example")
+
+    assert excinfo.value.returncode == 2
diff --git a/site/it/test/test_tee.py b/site/it/test/test_tee.py
new file mode 100644
index 0000000000..b94bd09a73
--- /dev/null
+++ b/site/it/test/test_tee.py
@@ -0,0 +1,119 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import subprocess
+from io import StringIO
+from unittest.mock import patch
+
+import pytest
+
+from site_checks.tee import Tee
+
+
+class Recorder:
+    def __init__(self) -> None:
+        self.writes = []
+        self.flushes = 0
+
+    def write(self, data: str) -> None:
+        self.writes.append(data)
+
+    def flush(self) -> None:
+        self.flushes += 1
+
+
+class FakeStdout:
+    def __init__(self, lines: list[str]) -> None:
+        self._iter = iter(lines)
+        self.closed = False
+
+    def __iter__(self):
+        return self
+
+    def __next__(self) -> str:
+        return next(self._iter)
+
+    def close(self) -> None:
+        self.closed = True
+
+
+class FakeProc:
+    def __init__(self, lines: list[str], rc: int) -> None:
+        self.stdout = FakeStdout(lines)
+        self._rc = rc
+
+    def wait(self) -> int:
+        return self._rc
+
+
+def test_tee_write_and_flush() -> None:
+    first = Recorder()
+    second = Recorder()
+    tee = Tee(first, second)
+
+    tee.write("hello")
+
+    assert first.writes == ["hello"]
+    assert second.writes == ["hello"]
+    assert first.flushes == 1
+    assert second.flushes == 1
+
+    tee.flush()
+
+    assert first.flushes == 2
+    assert second.flushes == 2
+
+
+def test_tee_run_writes_output_and_returns_rc() -> None:
+    recorder = Recorder()
+    tee = Tee(recorder)
+    proc = FakeProc(["first\n", "second\n"], rc=0)
+
+    with patch("site_checks.tee.subprocess.Popen", return_value=proc) as popen_mock:
+        rc = tee.run(["echo", "test"], cwd=None, env={"A": "B"})
+
+    popen_mock.assert_called_once_with(
+        ["echo", "test"],
+        cwd=None,
+        env={"A": "B"},
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        text=True,
+    )
+    assert recorder.writes == ["first\n", "second\n"]
+    assert proc.stdout.closed is True
+    assert rc == 0
+
+
+def test_tee_run_raises_on_check_failure() -> None:
+    tee = Tee(Recorder())
+    proc = FakeProc([], rc=5)
+
+    with patch("site_checks.tee.subprocess.Popen", return_value=proc):
+        with pytest.raises(subprocess.CalledProcessError):
+            tee.run(["nope"], check=True)
+
+
+def test_tee_printf_writes_to_files() -> None:
+    output = StringIO()
+    tee = Tee(output)
+
+    tee.printf("hello", "world")
+
+    assert output.getvalue() == "hello world\n"
diff --git a/site/layouts/guides/baseof.html b/site/layouts/guides/baseof.html
new file mode 100644
index 0000000000..61c8b03e8f
--- /dev/null
+++ b/site/layouts/guides/baseof.html
@@ -0,0 +1,52 @@
+<!doctype html>
+<html itemscope itemtype="http://schema.org/WebPage"
+    {{- with .Site.Language.LanguageDirection }} dir="{{ . }}" {{- end -}}
+    {{ with .Site.Language.Lang }} lang="{{ . }}" {{- end }} {{/**/ -}}
+    class="no-js">
+  <head>
+    {{ partial "head.html" . }}
+  </head>
+  <body class="td-{{ .Kind }}{{ with .Page.Params.body_class }} {{ . }}{{ end }}">
+    <header>
+      {{ partial "navbar.html" . }}
+    </header>
+    <div class="container-fluid td-outer">
+      <div class="td-main">
+        <div class="row flex-xl-nowrap">
+          <aside class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none">
+            {{ partial "sidebar.html" . }}
+          </aside>
+          <!-- Polaris custom flag to include the _right_ side page TOC -->
+          {{ if .Params.show_page_toc -}}
+          <aside class="d-none d-xl-block col-xl-2 td-sidebar-toc d-print-none">
+            {{ partial "toc.html" . }}
+          </aside>
+          {{ end -}}
+          <main class="col-12 col-md-9 col-xl-8 ps-md-5" role="main">
+            {{ partial "version-banner.html" . }}
+            {{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
+            <h1>{{ .Title }}</h1>
+            {{ $res := .Resources -}}
+            {{ $pageRelPermalink := .RelPermalink }}
+            {{ if $res }}
+              <div class="alert alert-primary">
+                <p class="alert-heading">
+                  ℹ️ Assets for this guide (can also be accessed from the <a href="https://github.com/apache/polaris/tree/main/site/content{{ $pageRelPermalink }}">Apache Polaris Git repository</a>)
+                </p>
+                <ul>
+                {{ range $res }}
+                  <li><a href="{{ .RelPermalink }}"><code>{{ .Name }}</code></a>
+                  </li>
+                {{ end }}
+                </ul>
+              </div>
+            {{ end }}
+            {{ block "main" . }}{{ end }}
+          </main>
+        </div>
+      </div>
+      {{ partial "footer.html" . }}
+    </div>
+    {{ partial "scripts.html" . }}
+  </body>
+</html>
\ No newline at end of file