Skip to content

docs: record which checks are required on main, and why no path filter#62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
forkwright merged 1 commit into from
Aug 26, 2026
Merged

docs: record which checks are required on main, and why no path filter #62

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -180,6 +180,20 @@ repo the token cannot search reads identically to one that never converted.
| forkwright/typikon | gate-attestation, release-pr-checks |
| forkwright/zetesis | gate-attestation, release-please, release-pr-checks, security |

## Required checks on main

`actionlint` and `event-shape-guards` are required status checks on `main`. Both live in
`actionlint.yml` and both run on **every** pull request.

WARNING for anyone editing `actionlint.yml`: do not reintroduce a `paths:` filter on its trigger.
It carried one (`.github/workflows/**`, `scripts/**`) until it became required, and a required
check that cannot run on some pull requests blocks those pull requests forever — nothing failing,
nothing pending, nothing to point at. This repository has watched that happen to a sibling repo's
`main`.

The cost is that a docs-only pull request re-lints unchanged workflows. That is seconds, and it is
the correct trade for the repository whose entire content is other repositories' CI.

## Visibility requirement

This repo must remain **public**. GitHub does not allow private repos to call
Expand Down