github
clarify that `if` operates before `matrix`
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#jobsjob_idif
What part(s) of the article would you like to see updated?
You can use the jobs.<job_id>.if conditional to prevent a job from running unless a condition is met. You can use any supported context and expression to create a conditional. For more information on which contexts are supported in this key, see "Contexts."
Add a paragraph noting that matrix operates after if.
Additional information
https://github.com/community/community/discussions/48705
@jsoref Sorry about that! Stalebot has been getting the jump on me recently! Reopening it now 💖
@jsoref - Thanks for raising this issue based on the community post. I think this is worth clarifying in https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idif.
Markdown file: https://github.com/github/docs-internal/blob/main/data/reusables/actions/jobs/section-using-conditions-to-control-job-execution.md?plain=1
I've marked this issue help-wanted. A PR for this, based on the information provided about, would be gratefully received, if you (or anyone else reading this) are able to do so. 👍
@cmwilson21 I've created https://github.com/github/docs/pull/27168 which would probably result in me being slightly less frustrated with this repository. I understand that some other bot will shoot it, but I'm hoping that you can see about applying some similar change to the workflow.
@hubwriter I presume you mean https://github.com/github/docs/blob/main/data/reusables/actions/jobs/section-using-conditions-to-control-job-execution.md?plain=1 as I don't (at this time) have access to github/docs-internal.