Update README and GitHub Actions to support HTML-only builds without swift-test backend

Author: sean-parent

.github/workflows/build.yml

@@ -2,6 +2,11 @@ name: Build mdBook
 
 on:
   workflow_call:
+    inputs:
+      run-swift-tests:
+        description: "Run the swift-test backend (HTML lands under book/html/)"
+        type: boolean
+        default: true
     outputs:
       artifact-path:
         description: "Path to the built book artifact"
@@ -14,7 +19,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     outputs:
-      artifact-path: ./better-code/book
+      artifact-path: ${{ inputs.run-swift-tests && './better-code/book/html' || './better-code/book' }}
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -39,7 +44,13 @@ jobs:
           chmod +x scripts/install-tools.sh
           ./scripts/install-tools.sh
 
+      - name: Configure HTML-only build
+        if: ${{ !inputs.run-swift-tests }}
+        working-directory: better-code
+        run: sed -i '/^# Tests all Swift code blocks/,$d' book.toml
+
       - name: Setup Swift
+        if: inputs.run-swift-tests
         uses: swift-actions/setup-swift@v2
 
       - name: Build with mdBook
@@ -49,5 +60,5 @@ jobs:
         uses: actions/upload-artifact@v7
         with:
           name: mdbook-build-ubuntu-latest
-          path: ./better-code/book
+          path: ${{ inputs.run-swift-tests && './better-code/book/html' || './better-code/book' }}
           retention-days: 1

.github/workflows/deploy.yml

@@ -19,6 +19,8 @@ concurrency:
 jobs:
   build:
     uses: ./.github/workflows/build.yml
+    with:
+      run-swift-tests: false
     permissions:
       contents: read
 

README.md

@@ -58,7 +58,7 @@ Open http://localhost:3000 in your browser.
 - No deployment; PR check shows build status
 
 **Main Branch:**
-- Builds book using mdBook with versions from `versions.txt`
+- Builds HTML only (no swift-test) using mdBook with versions from `versions.txt`
 - Deploys to GitHub Pages
 - Available at https://stlab.github.io/better-code/
 
@@ -77,7 +77,8 @@ All tool versions are centrally managed in `versions.txt`. To update:
 better-code/          # mdBook source and configuration
 ├── src/             # Markdown chapter files
 ├── book.toml        # mdBook configuration
-└── book/            # Generated HTML (gitignored)
+└── book/            # Generated output (gitignored)
+    └── html/        # HTML when swift-test backend is enabled (PR/CI)
 
 scripts/             # Installation scripts
 ├── install-tools.sh    # Linux/macOS
@@ -96,7 +97,8 @@ archive/             # Legacy Jekyll site (for reference only)
 mdbook build ./better-code
 ```
 
-Output will be in `./better-code/book/`.
+With all backends enabled (default), HTML is in `./better-code/book/html/`.
+An HTML-only build (as on deploy) writes to `./better-code/book/`.
 
 
 ## Legacy Content

better-code/book.toml

@@ -12,7 +12,6 @@ build-dir = "book"
 git-repository-url = "https://github.com/stlab/better-code"
 edit-url-template = "https://github.com/stlab/better-code/edit/main/better-code/{path}"
 site-url = "/better-code/"
-cname = "stlab.github.io"
 
 [output.html.search]
 enable = true