From 9940b46d755212d80ddd80a5251e132b5bc73946 Mon Sep 17 00:00:00 2001
From: davmano <111084241+davmano@users.noreply.github.com>
Date: Wed, 7 May 2025 15:17:33 -0500
Subject: [PATCH] docs: enhanced CLI install guide

---
 README.md | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)

diff --git a/README.md b/README.md
index 6938a1df..6e5bc914 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,82 @@ New user? See how it works: [Morning coffee with the faas-cli](https://blog.alex
 Already an OpenFaaS user? Try [5 tips and tricks for the OpenFaaS CLI](https://www.openfaas.com/blog/five-cli-tips/)
 
 ### Get started: Install the CLI
+#  Quick Start: Install the OpenFaaS CLI
+
+The OpenFaaS CLI (`faas-cli`) enables you to build, deploy, and manage serverless functions with ease.
+
+---
+
+##  Installation Options
+
+###  Recommended: Install via Arkade
+
+[Arkade](https://github.com/alexellis/arkade) simplifies the installation of `faas-cli` and other DevOps tools. 
+```bash
+curl -sSL https://get.arkade.dev | sudo -E sh
+arkade get faas-cli
+```
+
+> Note: Re-running the `arkade get` command updates `faas-cli` to the latest version.
+
+---
+
+###  Linux/macOS: Install via Bash Script
+
+```bash
+curl -sSL https://cli.openfaas.com | sudo -E sh
+```
+
+For non-root installation:
+
+```bash
+curl -sSL https://cli.openfaas.com | sh
+```
+
+---
+
+###  macOS: Install via Homebrew
+
+```bash
+brew install faas-cli
+```
+
+> Note: Homebrew versions may lag behind the latest release. For the most up-to-date version, consider using Arkade.
+
+---
+
+###  Windows: Install via PowerShell
+
+```powershell
+$version = (Invoke-WebRequest "https://api.github.com/repos/openfaas/faas-cli/releases/latest" | ConvertFrom-Json).tag_name
+Invoke-WebRequest "https://github.com/openfaas/faas-cli/releases/download/$version/faas-cli.exe" -OutFile "faas-cli.exe"
+```
+
+---
+
+## ✅ Verify Installation
+
+After installation, confirm that `faas-cli` is accessible:
+
+```bash
+faas-cli version
+```
+
+---
+
+## First Steps with `faas-cli`
+
+Once installed, you can start creating and deploying functions:
+
+```bash
+faas-cli new hello-python --lang python3
+faas-cli up -f hello-python.yml
+```
+
+This will scaffold a new Python function and deploy it to your OpenFaaS gateway.
+## Need Help?
+
+- 💬 [Community Support](https://docs.openfaas.com/community/)
 
 You can install the CLI with a `curl` utility script, `brew` or by downloading the binary from the releases page. Once installed you'll get the `faas-cli` command and `faas` alias.