Skip to content

Commit

Permalink
update readme (#82)
Browse files Browse the repository at this point in the history
  • Loading branch information
ericsciple committed Dec 3, 2019
1 parent e347bba commit 8461dbf
Show file tree
Hide file tree
Showing 3 changed files with 29 additions and 13 deletions.
20 changes: 10 additions & 10 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
# Changelog

## v2 (preview)
## v2 (beta)

- Improved fetch performance
- The default behavior now fetches only the SHA being checked-out.
- The default behavior now fetches only the SHA being checked-out
- Script authenticated git commands
- Persists `with.token` in the local git config.
- Enables your scripts to run authenticated git commands.
- Post-job cleanup removes the token.
- Coming soon: Opt out by setting `with.persist-credentials` to `false`.
- Persists `with.token` in the local git config
- Enables your scripts to run authenticated git commands
- Post-job cleanup removes the token
- Coming soon: Opt out by setting `with.persist-credentials` to `false`
- Creates a local branch
- No longer detached HEAD when checking out a branch.
- A local branch is created with the corresponding upstream branch set.
- No longer detached HEAD when checking out a branch
- A local branch is created with the corresponding upstream branch set
- Improved layout
- `with.path` is always relative to `github.workspace`.
- Aligns better with container actions, where `github.workspace` gets mapped in.
- `with.path` is always relative to `github.workspace`
- Aligns better with container actions, where `github.workspace` gets mapped in
- Removed input `submodules`


Expand Down
20 changes: 18 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,37 @@
<a href="https://github.com/actions/checkout"><img alt="GitHub Actions status" src="https://github.com/actions/checkout/workflows/test-local/badge.svg"></a>
</p>

# Checkout V2 (preview)
# Checkout V2 (beta)

This action checks-out your repository under `$GITHUB_WORKSPACE`, so your workflow can access it.

By default, the repository that triggered the workflow is checked-out, for the ref/SHA that triggered the event.

Refer [here](https://help.github.com/en/articles/events-that-trigger-workflows) to learn which commit `$GITHUB_SHA` points to for different events.

Changes in V2:
- Improved fetch performance
- The default behavior now fetches only the SHA being checked-out
- Script authenticated git commands
- Persists `with.token` in the local git config
- Enables your scripts to run authenticated git commands
- Post-job cleanup removes the token
- Coming soon: Opt out by setting `with.persist-credentials` to `false`
- Creates a local branch
- No longer detached HEAD when checking out a branch
- A local branch is created with the corresponding upstream branch set
- Improved layout
- `with.path` is always relative to `github.workspace`
- Aligns better with container actions, where `github.workspace` gets mapped in
- Removed input `submodules`

Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous versions.

# Usage

<!-- start usage -->
```yaml
- uses: actions/checkout@preview
- uses: actions/checkout@v2-beta
with:
# Repository name
# Default: ${{ github.repository }}
Expand Down
2 changes: 1 addition & 1 deletion src/misc/generate-docs.ts
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ function updateUsage(
}

updateUsage(
'actions/checkout@preview',
'actions/checkout@v2-beta',
path.join(__dirname, '..', '..', 'action.yml'),
path.join(__dirname, '..', '..', 'README.md')
)

0 comments on commit 8461dbf

Please sign in to comment.