Merge branch 'main' into agent/issue-45404-stacked-prs-docs-update-31225486808

Author: Sharra-writes

content/actions/reference/workflows-and-actions/workflow-syntax.md

@@ -283,7 +283,7 @@ The value of this parameter is a string specifying the data type of the input. T
 
 {% data reusables.actions.forked-write-permission %}
 
-## How permissions are calculated for a workflow job
+### How permissions are calculated for a workflow job
 
 The permissions for the `GITHUB_TOKEN` are initially set to the default setting for the enterprise, organization, or repository. If the default is set to the restricted permissions at any of these levels then this will apply to the relevant repositories. For example, if you choose the restricted default at the organization level then all repositories in that organization will use the restricted permissions as the default. The permissions are then adjusted based on any configuration within the workflow file, first at the workflow level and then at the job level. Finally, if the workflow was triggered by a pull request event other than `pull_request_target` from a forked repository, and the **Send write tokens to workflows from pull requests** setting is not selected, the permissions are adjusted to change any write permissions to read only.
 

content/pull-requests/how-tos/merge-and-close-pull-requests/optimizing-ci-for-stacked-pull-requests.md

@@ -55,7 +55,7 @@ jobs:
 
 Because a workflow runs for every pull request in a stack, you can use the `stack` fields to run expensive jobs only at the positions that matter. Two conditions are especially useful:
 
-* **Lowest unmerged pull request** — the pull request currently at the bottom of the remaining stack. Because it targets the stack base directly, `github.event.pull_request.stack.base.ref` equals `github.event.pull_request.base.ref`.
+* **Lowest unmerged pull request** — the pull request currently at the bottom of the remaining stack, targeting the stack base directly. It is the pull request where `github.event.pull_request.stack.base.ref` equals `github.event.pull_request.base.ref`.
 * **Top pull request** — the last pull request in the stack, containing the full set of changes. It is the pull request where `github.event.pull_request.stack.position` equals `github.event.pull_request.stack.size`.
 
 ```yaml