Update name

.github/workflows/deploy.yaml

@@ -0,0 +1,42 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+name: 'Deploy'
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    permissions:
+      # actions: read # Only required for private GitHub Repo
+      contents: read
+      deployments: write
+      pull-requests: write
+    runs-on: ubuntu-latest
+    environment: Cloudflare Pages
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+          cache: 'pip'
+      - name: Install Dependencies
+        run: |
+          pip install -r requirements.txt
+
+      - name: Build Docs Website
+        run: mkdocs build
+
+      - name: Deploy to Cloudflare Pages
+        uses: andykenward/github-actions-cloudflare-pages@v3.0.0
+        id: pages
+        with:
+          cloudflare-api-token: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          cloudflare-account-id: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
+          cloudflare-project-name: ${{ vars.CLOUDFLARE_PROJECT_NAME }}
+          directory: site
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          github-environment: Cloudflare Pages

.github/workflows/pr-close.yaml

@@ -1,30 +1,25 @@
-name: pr-close
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
 
+name: 'PR Close - Deletion'
 on:
   pull_request:
     types:
       - closed
-
-permissions:
-  contents: write
+    branches:
+      - main
 
 jobs:
-  cleanup:
+  deploy-delete:
+    permissions:
+      actions: read # Only required for private GitHub Repo
+      contents: read
+      deployments: write
+      pull-requests: write
     runs-on: ubuntu-latest
+    timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-python@v6
+      - name: Deploy deletion Cloudflare Pages
+        uses: andykenward/github-actions-cloudflare-pages/delete@v2.3.2
         with:
-          python-version: 3.12
-          cache: 'pip'
-      - name: Install Dependencies
-        run: |
-          pip install -r requirements.txt
-      - name: Setup Docs Deploy
-        run: |
-          git config --global user.name "Docs Deploy"
-          git config --global user.email "docs.deploy@example.co.uk"
-      - name: Build Docs Website
-        run: mike delete --push pr-${{ github.event.pull_request.number }}
+          cloudflare-api-token: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pr-preview-deploy.yaml

@@ -0,0 +1,57 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+# Trusted follow-up: runs in base-repo context so secrets and environments work (incl. fork PRs).
+# andykenward/github-actions-cloudflare-pages only supports push/pull_request/workflow_dispatch,
+# not workflow_run, so previews use wrangler directly (same pattern as Cloudflare docs).
+name: PR Preview Deploy
+on:
+  pull_request_target:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    environment: Cloudflare Pages
+    env:
+      PR_NUMBER: ${{ github.event.workflow_run.pull_requests[0].number }}
+    permissions:
+      contents: read
+      deployments: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          repository: ${{ github.event.workflow_run.head_repository.full_name || github.repository }}
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+          cache: pip
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+      - name: Build docs
+        run: mkdocs build
+
+      # - name: Deploy preview to Cloudflare Pages
+      #   id: pages
+      #   uses: cloudflare/wrangler-action@v3
+      #   with:
+      #     apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      #     accountId: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
+      #     command: >-
+      #       pages deploy site
+      #       --project-name=${{ vars.CLOUDFLARE_PROJECT_NAME }}
+      #       --branch=pr-${{ env.PR_NUMBER }}
+      #     gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+      - name: Deploy to Cloudflare Pages
+        uses: andykenward/github-actions-cloudflare-pages@v3.0.0
+        id: pages
+        with:
+          cloudflare-api-token: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          cloudflare-account-id: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
+          cloudflare-project-name: ${{ vars.CLOUDFLARE_PROJECT_NAME }}
+          directory: site
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          github-environment: Cloudflare Pages

.github/workflows/pr-check.yaml → .github/workflows/pr-preview-validate.yaml

@@ -1,14 +1,17 @@
-name: pr-check
-
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+# Runs without secrets (safe for fork PRs). PR Preview Deploy runs after this completes.
+name: PR Preview Validate
 on:
   pull_request:
-
-permissions:
-  contents: read
+    branches:
+      - main
 
 jobs:
-  pre-commit:
+  build:
     runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
     steps:
       - uses: actions/checkout@v3
         with:

.gitignore

@@ -5,3 +5,10 @@ rosetta
 .local
 share
 hooks/__pycache__/
+
+# wrangler files
+.wrangler
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example

wrangler.jsonc

@@ -0,0 +1,14 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "openshift-examples",
+  "compatibility_date": "2026-04-30",
+  "observability": {
+    "enabled": true
+  },
+  "assets": {
+    "directory": "site"
+  },
+  "compatibility_flags": [
+    "nodejs_compat"
+  ]
+}