From ca28077386065e263c03428f4ae0c09024817c93 Mon Sep 17 00:00:00 2001
From: Xiaoxuan Wang <103478229+wangxiaoxuan273@users.noreply.github.com>
Date: Thu, 6 Jun 2024 16:31:33 +0800
Subject: [PATCH] chore: update README to add an example (#30)

Signed-off-by: Xiaoxuan Wang <wangxiaoxuan119@gmail.com>
---
 README.md  | 16 ++++++++++++++--
 action.yml |  2 +-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 8d25a20..0e3938d 100644
--- a/README.md
+++ b/README.md
@@ -18,8 +18,7 @@ steps:
 
 ## Advanced Usage
 
-Install a specific version of the `oras` CLI by specifying the input `version` without the prefix `v`.
-Supported versions can be found at [`oras` releases](https://github.com/oras-project/oras/releases).
+Install a specific version of the `oras` CLI by specifying the input `version` without the prefix `v`. Stable versions (not pre-release versions) are supported and can be found at [`oras` releases](https://github.com/oras-project/oras/releases).
 
 For example, install `oras` version `v1.0.0`.
 
@@ -31,6 +30,19 @@ steps:
   - run: oras version
 ```
 
+You can also download `oras` CLI from any preferred trusted source, by specifying link of the source via `url` and the SHA256 checksum via `checksum`. This can be used to download a pre-release version or download from a proxy other than `github.com`. 
+
+For example, install `oras` version `v1.2.0-beta.1`.
+
+```yaml
+steps:
+  - uses: oras-project/setup-oras@v1
+    with:
+      url: https://github.com/oras-project/oras/releases/download/v1.2.0-beta.1/oras_1.2.0-beta.1_linux_amd64.tar.gz
+      checksum: 37d86f848f7c7c471035cf8218f06372fd72a9fbdca1e10f509738e222b3b2be
+  - run: oras version
+```
+
 ## Docs
 
 Documentation for the ORAS CLI is located on
diff --git a/action.yml b/action.yml
index 710acb8..af3b35e 100644
--- a/action.yml
+++ b/action.yml
@@ -22,7 +22,7 @@ inputs:
     required: false
     default: 1.2.0
   url:
-    description: URL of the customized ORAS CLI to install
+    description: URL of the customized ORAS CLI to install. Required if 'checksum' is present.
     required: false
   checksum:
     description: SHA256 of the customized ORAS CLI. Required if 'url' is present.