Skip to content

Update "Using conditions to control job execution" Github Actions documentation - #44105

Merged
mchammer01 merged 4 commits into
github:mainfrom
mcummings128:patch-6
Oct 13, 2026
Merged

mchammer01 merged 4 commits into
github:mainfrom
mcummings128:patch-6

Conversation

@mcummings128

Copy link
Copy Markdown
Contributor

Clarify usage of conditions in job execution and note limitations for shell conditions.

Why:

Closes: TBD

What's being changed (if available, include any code snippets, screenshots, or gifs):

The Github Actions documentation page "Using conditions to control job execution
" (see link below)

https://github.com/proxy/docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions

Adds a small blurb that shell conditionals are not supported/evaluated in jobs.<job_id>.if. While immediately obvious if trying to execute a workflow that does this, this should be stated explicitly. The phrase "You can use any supported context and expression to create a conditional." is not restrictive enough.

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

Clarify usage of conditions in job execution and note limitations for shell conditions.
@github-actions github-actions Bot added the triage Do not begin working on this issue until triaged by the team label May 6, 2026
@github-actions

github-actions Bot commented May 6, 2026 •

Copy link
Copy Markdown
Contributor

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions.md fpt
ghec
ghes@ 3.22 3.21 3.20 3.19 3.18
fpt
ghec
ghes@ 3.22 3.21 3.20 3.19 3.18

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@Sharra-writes Sharra-writes added github_actions Pull requests that update GitHub Actions content content This issue or pull request belongs to the Docs Content team and removed triage Do not begin working on this issue until triaged by the team labels May 12, 2026
@Sharra-writes

Copy link
Copy Markdown
Contributor

@mcummings128 Checking in with Actions about whether they think this is necessary or want to change any wording.

@Sharra-writes

Copy link
Copy Markdown
Contributor

@mcummings128 The Actions team doesn't want the documentation to discuss what can't be done in this article, but they did suggest linking to this article on expressions to better describe what can be done. I don't know if you want to do that in this PR, but it's an option if you don't mind changing what you've got.

@specialpreecha-gif

This comment was marked as spam.

@github-actions

Copy link
Copy Markdown
Contributor

A stale label has been added to this pull request because it has been open 30 days with no activity. If you think this pull request should remain open, please add a new comment.

@github-actions github-actions Bot added the Inactive Will be closed automatically by a stall check if no activity is detected. label Jun 22, 2026
@Sharra-writes Sharra-writes removed the Inactive Will be closed automatically by a stall check if no activity is detected. label Jul 6, 2026
@github-actions

Copy link
Copy Markdown
Contributor

A stale label has been added to this pull request because it has been open 30 days with no activity. If you think this pull request should remain open, please add a new comment.

@github-actions github-actions Bot added the Inactive Will be closed automatically by a stall check if no activity is detected. label Aug 17, 2026
@subatoi subatoi removed the Inactive Will be closed automatically by a stall check if no activity is detected. label Aug 17, 2026
@github github deleted a comment from mohammedjok Aug 27, 2026
@github-actions

Copy link
Copy Markdown
Contributor

A stale label has been added to this pull request because it has been open 30 days with no activity. If you think this pull request should remain open, please add a new comment.

@github-actions github-actions Bot added the Inactive Will be closed automatically by a stall check if no activity is detected. label Sep 28, 2026
@subatoi subatoi removed the Inactive Will be closed automatically by a stall check if no activity is detected. label Sep 28, 2026
mchammer01
mchammer01 previously approved these changes Oct 13, 2026

@mchammer01 mchammer01 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mcummings128 👋🏻 - nice catch, this is a genuinely useful clarification! ✨
LGTM 🙌🏻

Just one tiny nit. Made a suggestion and will apply it before merging.

@mchammer01 mchammer01 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Duh, thought I'd already approved this 😕

@mchammer01
mchammer01 enabled auto-merge October 13, 2026 13:58
@mchammer01
mchammer01 added this pull request to the merge queue Oct 13, 2026
Merged via the queue into github:main with commit 93069a0 Oct 13, 2026
48 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues ⚡

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

builder persona content This issue or pull request belongs to the Docs Content team github_actions Pull requests that update GitHub Actions content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants