Skip to content

Keep the library's API docs pages when the docs cache replays - #56

Merged
KellyJDavis merged 1 commit into
mainfrom
numina/aqft-in-lean
Nov 1, 2026
Merged

KellyJDavis merged 1 commit into
mainfrom
numina/aqft-in-lean

Conversation

@KellyJDavis

Copy link
Copy Markdown
Contributor

Every Physicslib4 page of the API docs returns 404 on the live site since #55.

Cause. The docs cache holds Lake's record that the project's docs were built, but not the pages. #54 rebuilt everything and saved that cache. #55 had the same Lean sources, so Lake replayed Physicslib4:docs and generated no pages (5,784 HTML files instead of 5,904). Any later run with unchanged Lean sources would do the same.

Fix.

  • Cache Physicslib4/ and Physicslib4.html with the record. Changing the cached paths also makes GitHub ignore the current cache, so the next deployment rebuilds in full (about 30 minutes more).
  • "Assemble the site" fails if the root module's page or the page of a module it imports is missing, so the existing site stays live.

Checks. Workflow YAML parses; wording check passes; the page check was run on sample trees (complete, one page missing, all missing).

Still to confirm. The caching needs two deployments to prove: this one rebuilds and saves the cache, and a later one with no Lean changes must keep the pages.

🤖 Generated with Claude Code

The docs cache holds Lake's record of the project's docs but not the pages,
so a run with unchanged Lean sources replayed the record, generated no pages
and deployed the API docs without them. Cache the project's pages too, and
stop the run before deployment if a page of the library is missing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@KellyJDavis
KellyJDavis merged commit 9d740b5 into main Nov 1, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant