diff --git a/.gitea/workflows/checks.yml b/.gitea/workflows/checks.yml index a7c3155..44709c0 100644 --- a/.gitea/workflows/checks.yml +++ b/.gitea/workflows/checks.yml @@ -116,8 +116,15 @@ name: checks # the guard lives inside the workflow that a filter makes Gitea skip. Blind # spot 3 is the one that matters: a filter naming a branch THIS pull request # does not target is itself skipped, lands green and untested, and then every -# subsequent pull request matching it is skipped too. That is the gate off, -# silently. +# subsequent pull request the filter DOES NOT NAME is skipped too. That is the +# gate off, silently. +# +# ⚠️ THAT DIRECTION IS THE WHOLE POINT AND IT IS EASY TO WRITE BACKWARDS. A +# pull request that MATCHES the filter still runs; it is the one the filter +# excludes that Gitea sits out, reports `skipped`, and the rollup launders +# into `success`. An earlier draft of this very clause said "matching it is +# skipped", which is the inverse of the measurement and contradicted the +# paragraph directly below. # # ⚠️ AND THE DANGEROUS ONE IS NOT `branches: [main]`, WHICH AT LEAST LOOKS # WRONG. It is `branches: [release/1.0]`, which looks like tightening onto the