Skip to content

ci: deploy the docs with the Pages actions - #69

Merged
petercorke merged 1 commit into
mainfrom
ci/docs-deploy-pages
Oct 13, 2026
Merged

petercorke merged 1 commit into
mainfrom
ci/docs-deploy-pages

Conversation

@petercorke

Copy link
Copy Markdown
Owner

The published documentation is out of date, and has been since January 2025.

  • GitHub Pages for this repository is set to deploy from a GitHub Actions artifact (build_type: workflow); the last build was 2025-01-08.
  • The docs job in ci.yml does peaceiris/actions-gh-pages, which pushes the HTML to the gh-pages branch. Nothing serves that branch any more: the branch has the current docs (and llms.txt, from docs: llms.txt, llms-full.txt and AGENTS.md #68), the site has not changed.
  • https://petercorke.github.io/pgraph-python/analysis.html, construction.html and llms.txt are all 404.

This switches the job to what ansitable and bdsim do: configure-pages, upload-pages-artifact and deploy-pages to the github-pages environment, with pages: write and id-token: write on that job only. The environment's branch policy already allows main. The build, the llms step and the conditions (a push, or a manual run from main) are unchanged.

Not testable on a PR: the job runs on pushes to main and the environment accepts only main. After it merges the push builds and deploys, and I will check the site; gh workflow run ci.yml --ref main repeats it.

🤖 Generated with Claude Code

The repository's Pages setting serves a GitHub Actions deployment, but the
docs job pushed to the gh-pages branch, which is not served: the live site
was last built in January 2025 and has no 1.0 pages, nor llms.txt.  The job
now uploads the build as a Pages artifact and deploys it, as ansitable and
bdsim do, to the github-pages environment (deployable from main).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@petercorke
petercorke merged commit c9d38e6 into main Oct 13, 2026
12 checks passed
@petercorke
petercorke deleted the ci/docs-deploy-pages branch October 13, 2026 01:26
@codecov

codecov Bot commented Oct 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.26%. Comparing base (7e763ea) to head (4714faf).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #69   +/-   ##
=======================================
  Coverage   97.26%   97.26%           
=======================================
  Files           3        3           
  Lines        1570     1570           
=======================================
  Hits         1527     1527           
  Misses         43       43           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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