Missing jobs.<job_id>.defaults.run.working-directory

[jsoref]

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_iddefaultsrun

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

There should be a jobs.<job_id>.defaults.run.working-directory

https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_iddefaultsrun
Says:

Use jobs.<job_id>.defaults.run to provide default shell and working-directory to all run steps in the job. This keyword can reference several contexts. For more information, see "Contexts."

That should be visible in the ToC on the right, and have proper paragraphs. I shouldn't have to read the entire document ot discover this.

Additional information

It should explain how it interacts with previous levels.

There's a workflow that uses a global:

defaults:
  run:
    working-directory: ruby

I have no idea how to reset the working directory to the default in one job.

[docs-bot]

This issue may have been opened accidentally. I'm going to close it now, but feel free to open a new issue with a more descriptive title or ask any questions in discussions!

[jsoref]

Refiled as #31346