Skip to content

refactor: consolidate workflows using dorny/paths-filter#59

Merged
TimGels merged 4 commits intomainfrom
feature/consolidate-workflows-paths-filter
Feb 7, 2026
Merged

refactor: consolidate workflows using dorny/paths-filter#59
TimGels merged 4 commits intomainfrom
feature/consolidate-workflows-paths-filter

Conversation

@TimGels
Copy link
Owner

@TimGels TimGels commented Feb 7, 2026

This pull request updates the pr-build-test.yml GitHub Actions workflow to improve efficiency and clarity by distinguishing between documentation and source code changes. The workflow now only triggers builds and tests when source code is modified, and provides a fast path for documentation-only changes.

- Replaced separate docs-validation.yml and miscellaneous-validation.yml with single workflow
- Implemented dorny/paths-filter pattern following Nextcloud/Immich approach
- Added changes pre-job to detect src vs docs changes
- Docs-only changes get fast check without full build/test
- Config-only changes (LICENSE, .gitignore, etc.) don't require CI checks
- Added concurrency control and explicit permissions
- Simplified maintenance with single workflow file
@TimGels TimGels requested a review from Copilot February 7, 2026 14:45
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the PR Build and Test workflow to avoid running full build/test on documentation-only changes by using dorny/paths-filter to gate subsequent jobs.

Changes:

  • Added a dedicated changes job that classifies PR modifications into src vs docs.
  • Introduced a docs-only fast-path job and gated build/test execution on src changes.
  • Added workflow-level permissions and concurrency controls.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

dorny/paths-filter needs access to base commit for PR diffs.
Without fetch-depth, shallow clone only has HEAD and filter fails.
dorny/paths-filter needs pull-requests: read to query PR files via GitHub API.
Following Nextcloud pattern of granting permission at job level (least privilege).
Markdown files in src/ or tests/ should not trigger full build/test.
Added negation patterns (!src/**/*.md, !tests/**/*.md) so markdown
changes are treated as docs-only regardless of location.
@TimGels TimGels merged commit 8366f8c into main Feb 7, 2026
6 checks passed
@TimGels TimGels deleted the feature/consolidate-workflows-paths-filter branch February 7, 2026 15:40
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