Skip to content

fix: exclude pre-release tags/branches from docs workflow#445

Merged
marc0olo merged 1 commit intomainfrom
fix/docs-workflow-cleanup
Mar 18, 2026
Merged

fix: exclude pre-release tags/branches from docs workflow#445
marc0olo merged 1 commit intomainfrom
fix/docs-workflow-cleanup

Conversation

@marc0olo
Copy link
Member

Changes

Remove workflow_dispatch from docs.yml

All publish jobs require github.event_name == 'push', so manually triggering docs.yml via workflow_dispatch only ran the build job — no publishing, no IC deployment. Keeping it was misleading.

docs-deploy.yml retains workflow_dispatch for manual IC re-deploys when needed.

Exclude pre-release tags and branches from trigger

Beta/RC tags (e.g. v0.2.0-beta.0) and beta doc branches (e.g. docs/v0.2.0-beta.5) previously triggered the workflow and deployed orphaned directories to the docs site (0.2.0-beta/, 0.2.1-beta/) that weren't listed in versions.json but were still deployed to the IC canister.

Added negation filters at the trigger level:

tags:
  - 'v*'
  - '!v*-*'    # exclude pre-release tags
branches:
  - main
  - 'docs/v*'
  - '!docs/v*-*'  # exclude pre-release doc branches

Trigger matrix

Event Ref Triggers?
push main (docs paths)
push docs/v0.1 (docs paths)
push refs/tags/v0.2.1
push refs/tags/v0.2.0-beta.0
push docs/v0.2.0-beta.5
pull_request any (docs paths) ✅ build only

…unused workflow_dispatch

- Pre-release tags (v*-*) and docs branches (docs/v*-*) now excluded at
  the trigger level, preventing beta releases from deploying to the docs site
- workflow_dispatch removed from docs.yml — publish jobs require push event
  so manual triggers only ran the build job, which was misleading.
  docs-deploy.yml retains workflow_dispatch for manual IC re-deploys.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@marc0olo marc0olo requested a review from a team as a code owner March 18, 2026 13:12
@marc0olo
Copy link
Member Author

beta folders were also removed via 67fd33e

@marc0olo marc0olo merged commit 603bf86 into main Mar 18, 2026
93 checks passed
@marc0olo marc0olo deleted the fix/docs-workflow-cleanup branch March 18, 2026 14:01
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.

2 participants