No doc of `on.merge_group.<branches|branches-ignore>`
- 主要語言
- 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