From a12a3943b4bdde767164f792f33f40b04645d846 Mon Sep 17 00:00:00 2001 From: Thomas Boop <52323235+thboop@users.noreply.github.com> Date: Tue, 1 Mar 2022 12:46:45 -0500 Subject: [PATCH] update readme for v3 (#708) * update readme for v3 * update readme with changes * nit grammar --- README.md | 45 ++++++++++++++------------------------- src/misc/generate-docs.ts | 2 +- 2 files changed, 17 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 775cee5..b185d46 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ GitHub Actions status

-# Checkout V2 +# Checkout V3 This action checks-out your repository under `$GITHUB_WORKSPACE`, so your workflow can access it. @@ -14,27 +14,14 @@ When Git 2.18 or higher is not in your PATH, falls back to the REST API to downl # What's new -- Improved performance - - Fetches only a single commit by default -- Script authenticated git commands - - Auth token persisted in the local git config -- Supports SSH -- Creates a local branch - - No longer detached HEAD when checking out a branch -- Improved layout - - The input `path` is always relative to $GITHUB_WORKSPACE - - Aligns better with container actions, where $GITHUB_WORKSPACE gets mapped in -- Fallback to REST API download - - When Git 2.18 or higher is not in the PATH, the REST API will be used to download the files - - When using a job container, the container's PATH is used - -Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous versions. +- Updated to the node16 runtime by default + - This requires a minimum [Actions Runner](https://github.com/actions/runner/releases/tag/v2.285.0) version of v2.285.0 to run, which is by default available in GHES 3.4 or later. # Usage ```yaml -- uses: actions/checkout@v2 +- uses: actions/checkout@v3 with: # Repository name with owner. For example, actions/checkout # Default: ${{ github.repository }} @@ -123,7 +110,7 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ## Fetch all history for all tags and branches ```yaml -- uses: actions/checkout@v2 +- uses: actions/checkout@v3 with: fetch-depth: 0 ``` @@ -131,7 +118,7 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ## Checkout a different branch ```yaml -- uses: actions/checkout@v2 +- uses: actions/checkout@v3 with: ref: my-branch ``` @@ -139,7 +126,7 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ## Checkout HEAD^ ```yaml -- uses: actions/checkout@v2 +- uses: actions/checkout@v3 with: fetch-depth: 2 - run: git checkout HEAD^ @@ -149,12 +136,12 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ```yaml - name: Checkout - uses: actions/checkout@v2 + uses: actions/checkout@v3 with: path: main - name: Checkout tools repo - uses: actions/checkout@v2 + uses: actions/checkout@v3 with: repository: my-org/my-tools path: my-tools @@ -164,10 +151,10 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ```yaml - name: Checkout - uses: actions/checkout@v2 + uses: actions/checkout@v3 - name: Checkout tools repo - uses: actions/checkout@v2 + uses: actions/checkout@v3 with: repository: my-org/my-tools path: my-tools @@ -177,12 +164,12 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ```yaml - name: Checkout - uses: actions/checkout@v2 + uses: actions/checkout@v3 with: path: main - name: Checkout private tools - uses: actions/checkout@v2 + uses: actions/checkout@v3 with: repository: my-org/my-private-tools token: ${{ secrets.GH_PAT }} # `GH_PAT` is a secret that contains your PAT @@ -195,7 +182,7 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous ## Checkout pull request HEAD commit instead of merge commit ```yaml -- uses: actions/checkout@v2 +- uses: actions/checkout@v3 with: ref: ${{ github.event.pull_request.head.sha }} ``` @@ -211,7 +198,7 @@ jobs: build: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 ``` ## Push a commit using the built-in token @@ -222,7 +209,7 @@ jobs: build: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 - run: | date > generated.txt git config user.name github-actions diff --git a/src/misc/generate-docs.ts b/src/misc/generate-docs.ts index a1c845d..57d2888 100644 --- a/src/misc/generate-docs.ts +++ b/src/misc/generate-docs.ts @@ -120,7 +120,7 @@ function updateUsage( } updateUsage( - 'actions/checkout@v2', + 'actions/checkout@v3', path.join(__dirname, '..', '..', 'action.yml'), path.join(__dirname, '..', '..', 'README.md') )