pipe-cd / pipe-cd/pipecd

Skip heavy CI jobs (Go test/lint/build, web, integration) for docs-only changes

Open
#7,007 7 comments 1 reaction 1 assignee View on GitHub

@Yashagarwal9798 is already working on this.

Since Aug 24, 2026.

Dominant language
Go
Stars
1.4k
Forks
364
Avg merge
1d 4h
Merged PRs (30d)
84

Description

What would you like to be added:

Skip the heavy CI jobs (Go test/lint/build, web, integration, CodeQL) for PRs that only change documentation files (docs/**, **.md).

Currently test.yaml, build.yaml, lint.yaml, gen.yaml, and codeql-analysis.yaml run on every PR with no path filters, so even a docs typo fix runs the full Go test/lint matrix (one job per module), govulncheck, web tests, and integration tests.

Note: go-test-completed and go-lint-completed are required checks, so a plain paths-ignore on the triggers would leave them stuck at "Expected" and block merging. Instead, a first job can detect changed paths (e.g. dorny/paths-filter) and the heavy jobs skip conditionally the existing *-completed gate jobs still report success, so required checks keep working.

Why is this needed:

Docs-only changes cannot affect test/lint/build results, so running these jobs wastes CI compute and runner queue slots, and slows down feedback for docs contributors.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.