Add callout that some contexts aren't available for use in the jobs.<job_id>.if conditional

[MarkIannucci]

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/using-workflows/workflow-syntax-for-github-actions#jobsjob_idif

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

Please add a callout that certain contexts are not available for use in the jobs.<job_id>.if conditional. If you attempt to use them, you get an Unrecognized named-value: '<context>'. error.

Adding links to issues where people on the internet have learned about this the hard way:

• Unrecognized named-value: 'matrix' in job if conditional actions/runner#1985
• Unrecognized named-value: 'env'. for job conditional actions/runner#1189

Additional information

No response

[welcome]

Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[cmwilson21]

@MarkIannucci Thanks for opening an issue and linking it to your PR! ✨

[cognitiaclaeves]

This is a necro-post, but I wanted to point out, in case anyone sees this later, that I don't think that PR #22437 addresses issue actions/runner#1189 at all -- to me, it is still completely vague as to whether or not one can refer to variables in env from the job context.

[cmwilson21]

@cognitiaclaeves 👋 - Would you mind opening your concern as a new issue? That way I can triage it and make sure someone gets eyes on it for review 👀