Behavior of `branches` filter on existing branches

Offen Anfängerfreundlich

#42,813 erstellt am 06.2.2026 9 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 2/5
Geschätzter Aufwand: 1-3 Stunden
Anfängerfreundlichkeit: 78/100

Issue-Typ: Dokumentation
Klarheit: Klar beschrieben
Aktivitätsstatus: Aktiv
Tech-Stack: github-actions
Bereich: ci-cd, documentation

Rechercherichtung

Beginne mit dem verlinkten Artikel zur Workflow-Syntax und prüfe die Abschnitte zu den Branch-Filtern für pull_request und push. Aktualisiere die Dokumentation, um zu erklären, wie sich bereits vorhandene passende Branches verhalten, wenn ein Workflow oder Filter hinzugefügt wird, und bewahre dabei die umgebenden Hinweise. Als erledigt gilt die Aufgabe, wenn das beschriebene Verhalten in beiden relevanten Abschnitten eindeutig dokumentiert ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

content github_actions never-stale

Code of Conduct

I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax

What part(s) of the article would you like to see updated?

These to parts that describe using a branches filter:

Additional information

I just lost about 5 hours trying a large variety of variations and reviewing the docs related to branches filters on GitHub Actions. Here is what I discovered, and I believe this important fact is nowhere in the docs and should be:

    When a workflow is put in place that has a `branches` filter, or modified
    to add additional branches to an existing `branches` filter, any matching
    branches that already existed PRIOR to this modification are NOT eligible
    to trigger the workflow.

    Only new branches added AFTER the workflow is in place, with matching
    branch names, can trigger the workflow.

Vorherrschende Sprache: TypeScript
Sterne: 20.9k
Forks: 68.8k
Ø Merge: 15 Std. 4 Min.
Gemergte PRs (30 T.): 103

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus github/docs

Clarify that `DO_NOT_TRACK` only disables telemetry if `1` or `true` Offen

builder persona content

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 90/100

github/docs#45957 · 2 Kommentare · Erstellt am 19.9.2026
Simplified Chinese GitHub Mobile article displays an untranslated English body Offen

localization

Schwierigkeit 2/5 1-2 Tage Anfängerfreundlichkeit 72/100

github/docs#45949 · 1 Kommentar · Erstellt am 18.9.2026
Docs say a PR from a linked branch is "automatically linked" to the issue, but it is not when the PR targets a non-default branch Offen

builder persona

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100

github/docs#45948 · 2 Kommentare · Erstellt am 18.9.2026
[ja] Broken table rendering on "GitHub language support" Offen

content localization

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100

github/docs#45858 · 2 Kommentare · 1 Reaktion · Erstellt am 12.9.2026
Wrong translation in French version of the "Manually running a workflow" article Offen

content localization

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 92/100

github/docs#45773 · 2 Kommentare · Erstellt am 06.9.2026

Alle Issues in github/docs