Skip to content

ci: make docs workflow dispatch-only (GitHub Pages never enabled) - #124

Merged
ajianaz merged 1 commit into
developfrom
fix/123-docs-workflow
Sep 30, 2026
Merged

ajianaz merged 1 commit into
developfrom
fix/123-docs-workflow

Conversation

@ajianaz

@ajianaz ajianaz commented Sep 30, 2026

Copy link
Copy Markdown
Contributor

What

Convert .github/workflows/docs.yml from a push-triggered GitHub Pages deploy into a workflow_dispatch-only Docs Build Check: the deploy job is removed, the VitePress build job stays as an on-demand verification that uploads docs-dist as a regular artifact (7-day retention).

Why

The workflow failed on every push to main (4 consecutive failures since 2026-08-28): the deploy-pages@v4 step 404s because GitHub Pages was never enabled for this repo — docs are hosted on Cloudflare Pages since #49 (cosy-docs-4f5.pages.dev, deployed via wrangler). The failures were pure CI noise. Closes #123.

Testing

  • python3 -c "import yaml; yaml.safe_load(...)" — YAML valid
  • Workflow no longer triggers on push (only workflow_dispatch) — the failure source is structurally removed
  • bun run build step + empty-output guard unchanged from the previously-green build job
  • CI on this PR (the push trigger removal doesn't affect PR CI)

The push-to-main trigger failed on every main push because the deploy
step requires GitHub Pages, which was never enabled for this repo;
docs are hosted on Cloudflare Pages (since #49). Drop the deploy job,
keep the VitePress build as an on-demand check with a regular artifact.

Closes #123
@github-actions

Copy link
Copy Markdown

🔍 Cora AI Code Review

✅ No issues found. Code looks good!


Review powered by cora-code · BYOK · MIT

@ajianaz
ajianaz merged commit 2dad3bc into develop Sep 30, 2026
11 checks passed
@ajianaz
ajianaz deleted the fix/123-docs-workflow branch September 30, 2026 01:02
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.

ci: disable or fix vestigial docs.yml (GitHub Pages) workflow — fails on every main push

1 participant