Update README.md

README.md

@@ -10,7 +10,8 @@ By default, the repository that triggered the workflow is checked-out, for the r
 
 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:
+# What's new
+
 - Improved fetch performance
   - The default behavior now fetches only the SHA being checked-out
 - Script authenticated git commands
@@ -38,8 +39,9 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous
     # Default: ${{ github.repository }}
     repository: ''
 
-    # Ref to checkout (SHA, branch, tag). For the repository that triggered the
+    # The branch, tag or SHA to checkout.  When checking out the repository that
-    # workflow, defaults to the ref/SHA for the event. Otherwise defaults to master.
+    # triggered a workflow, this defaults to the reference or SHA for that event.
+    # Otherwise, defaults to `master`.
     ref: ''
 
     # Access token for clone repository
@@ -87,7 +89,7 @@ Refer [here](https://github.com/actions/checkout/blob/v1/README.md) for previous
 ```yaml
 - uses: actions/checkout@v2-beta
   with:
-    ref: refs/pull/${{ github.event.number }}/head
+    ref: ${{ github.event.after }}
 ```
 
 # License

action.yml

@@ -1,13 +1,14 @@
 name: 'Checkout'
-description: 'Checkout a Git repository'
+description: 'Checkout a Git repository at a particular version'
 inputs: 
   repository:
     description: 'Repository name with owner. For example, actions/checkout'
     default: ${{ github.repository }}
   ref:
     description: >
-      Ref to checkout (SHA, branch, tag). For the repository that triggered the
+      The branch, tag or SHA to checkout.  When checking out the repository
-      workflow, defaults to the ref/SHA for the event. Otherwise defaults to master.
+      that triggered a workflow, this defaults to the reference or SHA for
+      that event.  Otherwise, defaults to `master`.
   token:
     description: 'Access token for clone repository'
     default: ${{ github.token }}