diff --git a/docs/concepts-guidelines.md b/docs/concepts-guidelines.md index f840c6c..ddbd5b0 100644 --- a/docs/concepts-guidelines.md +++ b/docs/concepts-guidelines.md @@ -7,6 +7,7 @@ This document covers terminology, how the action works, and general usage guidel - [How the action works](#how-the-action-works) - [Guidelines](#guidelines) - [Providing a consistent base](#providing-a-consistent-base) + - [The pull request target repository](#the-pull-request-target-repository) - [Pull request events](#pull-request-events) - [Restrictions on forked repositories](#restrictions-on-forked-repositories) - [Tag push events](#tag-push-events) @@ -72,6 +73,26 @@ jobs: Although rare, there may be use cases where it makes sense to execute the workflow on a branch that is not the base of the pull request. In these cases, the base branch can be specified with the `base` action input. The action will attempt to rebase changes made during the workflow on to the actual base. +### The pull request target repository + +The action determines what repository it should create the pull request in based on the checked out repository. + +Checking out a branch from a different repository from where the workflow is executing will make *that repository* the target for the created pull request. In this case, a `repo` scoped [Personal Access Token (PAT)](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) is required. + +```yml + - uses: actions/checkout@v2 + with: + token: ${{ secrets.PAT }} + repository: owner/repo + + - name: Create changes to pull request + run: + + - uses: peter-evans/create-pull-request@v2 + with: + token: ${{ secrets.PAT }} +``` + ### Pull request events Workflows triggered by `pull_request` events will by default check out a [merge commit](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows#pull-request-event-pull_request). To prevent the merge commit being included in created pull requests it is necessary to checkout the `head_ref`.