docs: update default branch

This commit is contained in:
Peter Evans 2021-05-13 09:43:00 +09:00
parent 9f83247b25
commit fff683e9ca
2 changed files with 14 additions and 14 deletions

View file

@ -98,7 +98,7 @@ Workflows triggered by [`release`](https://docs.github.com/en/actions/reference/
```yml ```yml
- uses: peter-evans/create-pull-request@v3 - uses: peter-evans/create-pull-request@v3
with: with:
base: master base: main
``` ```
### Restrictions on repository forks ### Restrictions on repository forks
@ -164,7 +164,7 @@ Alternatively, use the action directly and reference the commit hash for the ver
- uses: thirdparty/foo-action@172ec762f2ac8e050062398456fccd30444f8f30 - uses: thirdparty/foo-action@172ec762f2ac8e050062398456fccd30444f8f30
``` ```
This action uses [ncc](https://github.com/vercel/ncc) to compile the Node.js code and dependencies into a single JavaScript file under the [dist](https://github.com/peter-evans/create-pull-request/tree/master/dist) directory. This action uses [ncc](https://github.com/vercel/ncc) to compile the Node.js code and dependencies into a single JavaScript file under the [dist](https://github.com/peter-evans/create-pull-request/tree/main/dist) directory.
## Advanced usage ## Advanced usage

View file

@ -38,7 +38,7 @@ name: Update AUTHORS
on: on:
push: push:
branches: branches:
- master - main
jobs: jobs:
updateAuthors: updateAuthors:
runs-on: ubuntu-latest runs-on: ubuntu-latest
@ -62,14 +62,14 @@ jobs:
This is a use case where a branch should be kept up to date with another by opening a pull request to update it. The pull request should then be updated with new changes until it is merged or closed. This is a use case where a branch should be kept up to date with another by opening a pull request to update it. The pull request should then be updated with new changes until it is merged or closed.
In this example scenario, a branch called `production` should be updated via pull request to keep it in sync with `master`. Merging the pull request is effectively promoting those changes to production. In this example scenario, a branch called `production` should be updated via pull request to keep it in sync with `main`. Merging the pull request is effectively promoting those changes to production.
```yml ```yml
name: Create production promotion pull request name: Create production promotion pull request
on: on:
push: push:
branches: branches:
- master - main
jobs: jobs:
productionPromotion: productionPromotion:
runs-on: ubuntu-latest runs-on: ubuntu-latest
@ -79,8 +79,8 @@ jobs:
ref: production ref: production
- name: Reset promotion branch - name: Reset promotion branch
run: | run: |
git fetch origin master:master git fetch origin main:main
git reset --hard master git reset --hard main
- name: Create Pull Request - name: Create Pull Request
uses: peter-evans/create-pull-request@v3 uses: peter-evans/create-pull-request@v3
with: with:
@ -96,7 +96,7 @@ This pattern will work well for updating any kind of static content based on the
Raises a pull request to update the `CHANGELOG.md` file based on the tagged commit of the release. Raises a pull request to update the `CHANGELOG.md` file based on the tagged commit of the release.
Note that [git-chglog](https://github.com/git-chglog/git-chglog/) requires some configuration files to exist in the repository before this workflow will work. Note that [git-chglog](https://github.com/git-chglog/git-chglog/) requires some configuration files to exist in the repository before this workflow will work.
This workflow assumes the tagged release was made on a default branch called `master`. This workflow assumes the tagged release was made on a default branch called `main`.
```yml ```yml
name: Update Changelog name: Update Changelog
@ -123,7 +123,7 @@ jobs:
title: Update Changelog title: Update Changelog
body: Update changelog to reflect release changes body: Update changelog to reflect release changes
branch: update-changelog branch: update-changelog
base: master base: main
``` ```
## Use case: Create a pull request to update X periodically ## Use case: Create a pull request to update X periodically
@ -174,9 +174,9 @@ The above workflow works best in combination with a build workflow triggered on
name: CI name: CI
on: on:
push: push:
branches: [master] branches: [main]
pull_request: pull_request:
branches: [master] branches: [main]
jobs: jobs:
build: build:
runs-on: ubuntu-latest runs-on: ubuntu-latest
@ -325,7 +325,7 @@ jobs:
This example is designed to be run in a seperate repository from the fork repository itself. This example is designed to be run in a seperate repository from the fork repository itself.
The aim of this is to prevent committing anything to the fork's default branch would cause it to differ from the upstream. The aim of this is to prevent committing anything to the fork's default branch would cause it to differ from the upstream.
In the following example workflow, `owner/repo` is the upstream repository and `fork-owner/repo` is the fork. It assumes the default branch of the upstream repository is called `master`. In the following example workflow, `owner/repo` is the upstream repository and `fork-owner/repo` is the fork. It assumes the default branch of the upstream repository is called `main`.
The [Personal Access Token (PAT)](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) should have `repo` scope. Additionally, if the upstream makes changes to the `.github/workflows` directory, the action will be unable to push the changes to a branch and throw the error "_(refusing to allow a GitHub App to create or update workflow `.github/workflows/xxx.yml` without `workflows` permission)_". To allow these changes to be pushed to the fork, add the `workflow` scope to the PAT. Of course, allowing this comes with the risk that the workflow changes from the upstream could run and do something unexpected. Disabling GitHub Actions in the fork is highly recommended to prevent this. The [Personal Access Token (PAT)](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) should have `repo` scope. Additionally, if the upstream makes changes to the `.github/workflows` directory, the action will be unable to push the changes to a branch and throw the error "_(refusing to allow a GitHub App to create or update workflow `.github/workflows/xxx.yml` without `workflows` permission)_". To allow these changes to be pushed to the fork, add the `workflow` scope to the PAT. Of course, allowing this comes with the risk that the workflow changes from the upstream could run and do something unexpected. Disabling GitHub Actions in the fork is highly recommended to prevent this.
@ -346,8 +346,8 @@ jobs:
- name: Reset the default branch with upstream changes - name: Reset the default branch with upstream changes
run: | run: |
git remote add upstream https://github.com/owner/repo.git git remote add upstream https://github.com/owner/repo.git
git fetch upstream master:upstream-master git fetch upstream main:upstream-main
git reset --hard upstream-master git reset --hard upstream-main
- name: Create Pull Request - name: Create Pull Request
uses: peter-evans/create-pull-request@v3 uses: peter-evans/create-pull-request@v3
with: with: