fix(docs): harden GitHub Pages deployment - #103
Merged
Conversation
wangjk9527
self-requested a review
August 6, 2026 14:34
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
tui-demo.mp4from the MkDocs Pages artifact while keeping it in the repositoryactions/deploy-pagespolling timeout from 10 to 20 minutesRoot cause
The docs build and artifact upload both succeed. Starting with
5e9bcff, GitHub Pages remainsdeployment_in_progressuntilactions/deploy-pagesreaches its default 10-minute timeout. The site artifact changed by only about 18 KB in that commit, while an identical-size artifact had already slowed from seconds to 4m37s, indicating Pages backend processing degradation rather than invalid DataLink docs.The artifact was approximately 67.6 MB because MkDocs copied a 31 MB MP4 used only by the repository README. Excluding that duplicate payload reduces the generated site to about 40 MB and the longer timeout tolerates transient Pages processing delays.
Verification
uv run --with-requirements requirements-docs.txt mkdocs build --strictnode scripts/smoke-doc-links.mjssite/assets/readme/tui-demo.mp4is absent and the repository source asset remains availableCloses #104