github / github/docs

No doc of `on.merge_group.<branches|branches-ignore>`

未關閉 適合新手
#32,879 14 則留言 3 個 reaction 已指派 0 人 在 GitHub 檢視
actions content help wanted never-stale SME reviewed
主要語言
TypeScript
星號
20.8k
分支
68.7k
平均合併
13 小時 10 分鐘
30 天內合併 PR
111

描述

### Code of Conduct

- [X] I have read and agree to the GitHub Docs project's [Code of Conduct](https://github.com/github/docs/blob/main/.github/CODE_OF_CONDUCT.md)

### What article on docs.github.com is affected?

https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions

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

GitHub Actions `merge_group` trigger supports `branches` filter since its [beta release](https://github.blog/changelog/2022-08-18-merge-group-webhook-event-and-github-actions-workflow-trigger/) in Aug 2022, but it's not documented till now.

I guess the symmetric `branches-ignore` filter is also supported but didn't check it myself.

One option is to extend current section [`on..`](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#onpull_requestpull_request_targetbranchesbranches-ignore) to cover `merge_group` and taking care of old anchor name redirection. Or add a separate `on.merge_group.` section.

### Additional information

Relevant GitHub Blogs

- Beta https://github.blog/changelog/2022-08-18-merge-group-webhook-event-and-github-actions-workflow-trigger/
- Public beta https://github.blog/changelog/2023-04-19-pull-request-merge-queue-public-beta-api-support-and-recent-fixes/
- Generally available https://github.blog/changelog/2023-07-12-pull-request-merge-queue-is-now-generally-available/

Related
- https://github.com/actions/languageservices/pull/12
- https://github.com/actions/languageservices/issues/18
- Path filtering does not work for merge_group triggers https://github.com/orgs/community/discussions/45899

貢獻指南

開啟貢獻指南

研究方向

從工作流程語法文章及其 on.pull_request|pull_request_target.branches|branches-ignore 區段開始。檢查連結的 GitHub changelog 和相關 issue,以確認 merge_group 是否支援這兩個篩選器,然後更新相關文件;如果擴充該區段,則透過重新導向保留現有錨點。完成的標準是準確記錄 merge_group 的分支篩選器行為。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
github-actions
領域
documentation
Issue 類型
文件
難度
2/5
預估耗時
1-3 小時
活躍度
冷清
描述清晰度
基本清楚
新手友好度
68/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。