Skip to content

Skip build/test/publish for documentation-only PRs#970

Merged
erikdarlingdata merged 1 commit into
devfrom
fix/skip-build-for-doc-only-prs
May 20, 2026
Merged

Skip build/test/publish for documentation-only PRs#970
erikdarlingdata merged 1 commit into
devfrom
fix/skip-build-for-doc-only-prs

Conversation

@erikdarlingdata
Copy link
Copy Markdown
Owner

Summary

A documentation-only change (CHANGELOG, README, etc.) triggered a full ~15-minute compile of Dashboard, Lite, and the Installer — pointless, since nothing compilable changed.

The existing dorny/paths-filter step now also computes a code output (true when any non-*.md file changed). The Setup/Restore/Build/Test/Publish steps are gated on steps.filter.outputs.code != 'false'.

  • Code PRs / pushes — build runs exactly as before.
  • Doc-only PRs / pushes — build/test/publish steps skip; the job runs only checkout + the filter and finishes in seconds. The build check still reports (green) because the job runs — not skipped at the workflow level, which would leave the required check stuck pending.
  • Release builds — unaffected. The filter step doesn't run on release events, so code is empty and the gate (code != 'false') treats empty as "run".

Same pattern as #968 (check-version-bump).

Bootstrap note

The dev → main PR carrying this fix changes a workflow file (not a doc), so check-version runs and fails once — needs one admin merge. (After this, doc-only PRs are clean on both checks.)

Test plan

  • yaml.safe_load parses clean
  • Release path traced: filter skipped on release → code empty → '' != 'false' → all build steps run
  • Confirm on first doc-only PR after merge that build reports green in seconds

🤖 Generated with Claude Code

A documentation-only change (CHANGELOG, README, etc.) triggered a full
~15-minute compile of Dashboard, Lite, and the Installer for no reason.
The paths-filter step now also computes a 'code' output (true when any
non-*.md file changed), and the build/test/publish steps are gated on
it. Documentation-only PRs and pushes run only checkout + the filter,
so the required 'build' check still reports — green — without the
workflow being skipped outright.

Release builds are unaffected: the filter step does not run on release
events, leaving 'code' empty, and the gate (code != 'false') treats an
empty value as "run".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@erikdarlingdata erikdarlingdata merged commit 4b36847 into dev May 20, 2026
2 checks passed
@erikdarlingdata erikdarlingdata deleted the fix/skip-build-for-doc-only-prs branch May 20, 2026 02:00
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