From ff7cac60841c8312b418a87d2feb55be82cb72af Mon Sep 17 00:00:00 2001 From: Test User Date: Wed, 12 Aug 2026 11:53:52 +0100 Subject: [PATCH] Revert "ci: build docs from SUMMARY.md rather than by walking the directory" MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts the switch to `md-book build .`, restoring `md-book -i . -o book`. The change cut the published site from 574 pages to 59. I framed that as removing archives and artefacts; it also removed real, linked content — PERFORMANCE_BENCHMARKING_README, the research and validation documents at the docs root, and 165 archived pages that were nonetheless live. Anything linking to them now 404s. SUMMARY.md describes 59 chapters, but the site has been publishing everything under docs/ for as long as md-book has built it, and readers and links depend on that. Narrowing the published surface is a content decision for the docs owner, not a side effect of a build-tool upgrade. Restores the previous behaviour first; the narrowing can be proposed separately, with the missing pages either added to SUMMARY.md or explicitly retired. --- .github/workflows/deploy-docs.yml | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml index 820820261..290ce2bf0 100644 --- a/.github/workflows/deploy-docs.yml +++ b/.github/workflows/deploy-docs.yml @@ -59,15 +59,10 @@ jobs: ls -la echo "DEBUG: Checking md-book binary:" ls -la /tmp/md-book/target/release/ || echo "md-book binary not found" - echo "Building with md-book (SUMMARY.md-driven)" + echo "DEBUG: Building with md-book fork..." rm -rf book/ - # `build .` reads book.toml, so it honours `src` and the SUMMARY.md - # ordering. The old `-i . -o book` pointed at the docs root, which has - # no SUMMARY.md, so md-book fell back to walking the directory and - # published 574 pages — archives, research notes and artefacts - # included — in path order rather than the 59 the summary declares. - /tmp/md-book/target/release/md-book build . - echo "Pages built: $(find book -name '*.html' | wc -l)" + /tmp/md-book/target/release/md-book -i . -o book || true + echo "DEBUG: Build completed with exit code: $?" - name: Upload build artifact uses: actions/upload-artifact@v5