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

[muzimuzhi]

Code of Conduct

• [X] 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/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 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.<pull_request|pull_request_target>.<branches|branches-ignore> to cover merge_group and taking care of old anchor name redirection. Or a separate on.merge_group.<branches|branches-ignore> section can be added.

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

[nguyenalex836]

@muzimuzhi Thank you for opening this issue! I'll get this triaged for review ✨