Skip to content

Let the docs workflow run by hand to repeat a failed deploy - #46

Merged
timlichtenberg merged 1 commit into
mainfrom
tl/docs-workflow-dispatch
Nov 10, 2026
Merged

timlichtenberg merged 1 commit into
mainfrom
tl/docs-workflow-dispatch

Conversation

@timlichtenberg

Copy link
Copy Markdown
Member

Description

The docs deploy for the merge of #45 failed in actions/deploy-pages: the GitHub artifact API answered "Failed to ListArtifacts ... (404) Not Found: check suite does not exist" (https://github.com/FormingWorlds/ZEPHYRUS/actions/runs/42831745851). The build in the same job passed. A re-run of the failed job then failed with "Multiple artifacts named github-pages were unexpectedly found for this workflow run", because the re-run uploads a second artifact into the same run. The workflow runs only on a push to main or master, so the live page still shows the value from before #45 (14.67 on https://proteus-framework.org/ZEPHYRUS/Reference/parameters.html) until the next merge.

This PR adds workflow_dispatch to .github/workflows/docs.yaml, so a failed deploy can run again as a new run with one artifact. The deploy job now runs only for main and master, the branches of the push trigger, so a manual run on another branch builds and deploys nothing. Nothing else changes. The merge of this PR runs the deploy once more.

Validation of changes

  • The workflow file parses, with triggers push (main, master) and workflow_dispatch, and the guard on the single deploy job. Read with a YAML parser, and checked with actionlint 1.7.12: rc 0, and a misspelt github.reff in the guard is flagged.
  • A manual run can only be checked once this file is on main, because the "Run workflow" button reads the default branch.

Lines from git diff --numstat and sizes from git ls-tree -l, base d2b1475 to tip c1e6d12:

Category Files Lines added / removed Size on disk (KiB) Compressed (KiB)
other 1 +2 / -0 +0.1 +0.0
total 1 +2 / -0 +0.1 +0.0

Checklist

  • I have followed the contributing guidelines
  • My code follows the style guidelines of this project (actionlint)
  • I have performed a self-review of my code
  • My changes generate no new warnings or errors
  • I have checked that the tests still pass on my computer
  • I have updated the docs, as appropriate
  • I have added tests for these changes, as appropriate
  • I have checked that all dependencies have been updated, as required

Relevant people

A Pages deploy that fails on the GitHub side can now run again from the Actions tab without a new push to main. The deploy job runs only on main or master, so a manual run on another branch is skipped and deploys nothing.
@timlichtenberg
timlichtenberg merged commit 623189e into main Nov 10, 2026
9 checks passed
@timlichtenberg
timlichtenberg deleted the tl/docs-workflow-dispatch branch November 10, 2026 16:13
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