### 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/how-tos/write-workflows/choose-when-workflows-run ### What part(s) of the article would you like to see updated? Add a page "Require manual approval for a specific job" ### Additional information - https://github.com/community/community/discussions/186436 asked if it was possible - https://github.com/community/community/discussions/186436#discussioncomment-15809572 explains that it's possible 1. Visit https://github.com/check-spelling-sandbox/super-duper-fishstick/settings/environments (or similar) 2. Click [New environment](https://github.com/check-spelling-sandbox/super-duper-fishstick/settings/environments/new) (or similar) 3. Name it (for my example, I picked `spelling`) 4. Check `Required reviewers` 5. Fill in reviewers <img width="788" height="295" alt="Image" src="https://github.com/user-attachments/assets/bc676c4c-9979-43f2-9de3-5f6293d6f0d2" /> 6. Save 7. Update the workflow to include [`environment:`](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idenvironment) as in https://github.com/check-spelling-sandbox/super-duper-fishstick/blob/1a6c62c10d1310abfeb58d5b15b73c57b2c768a3/.github/workflows/spelling.yml#L84 --- 1. When a workflow run is triggered, it will appear queued: <img width="1288" height="153" alt="Image" src="https://github.com/user-attachments/assets/a3113d47-7437-407e-88bc-9698c8d73b38" /> 2. Clicking the workflow run will yield something like: <img width="1662" height="869" alt="Image" src="https://github.com/user-attachments/assets/4e0796b3-4a83-461c-bdcc-4cae5b9dc766" /> 3. Clicking `Review deployments` yields an approval dialog: <img width="643" height="391" alt="Image" src="https://github.com/user-attachments/assets/90b821ac-c916-44b2-b20e-d5152faf6114" /> 4. Check the environment and then click Approve and deploy 5. The job will start running: <img width="1688" height="876" alt="Image" src="https://github.com/user-attachments/assets/c5b488d4-4383-4450-adb5-85c99e039b28" />
Code of Conduct
What article on docs.github.com is affected?
https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run
What part(s) of the article would you like to see updated?
Add a page "Require manual approval for a specific job"
Additional information
spelling)Required reviewersenvironment:as in https://github.com/check-spelling-sandbox/super-duper-fishstick/blob/1a6c62c10d1310abfeb58d5b15b73c57b2c768a3/.github/workflows/spelling.yml#L84Review deploymentsyields an approval dialog: