From 34867444a6d1202ebc90b9c53d83b29a8ed600ef Mon Sep 17 00:00:00 2001
From: Imani Manyara <19682005+imanimanyara@users.noreply.github.com>
Date: Sat, 3 Oct 2026 15:19:29 -0400
Subject: [PATCH] Rename the quick start to Quick start guide and usage

The README standard now splits the section into Getting started, the setup a fresh install needs before the first call, and Usage. Every command, tag and env key shown was checked against the package's own provider, config or CLI.
---
 README.md | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 53c789a..ba16a1c 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ irm https://get.simtabi.com/install.ps1 | iex
 ## Table of contents
 
 - [Why this exists](#why-this-exists)
-- [Quick start](#quick-start)
+- [Quick start](#quick-start-guide-and-usage)
 - [What ships in the box](#what-ships-in-the-box)
 - [URL layout at `get.simtabi.com`](#url-layout-at-getsimtabicom)
 - [Project layout](#project-layout)
@@ -65,7 +65,18 @@ gold-standard one-liner), `Homebrew` (prompt-before-privileged-step),
 `Docker get.docker.com` (distribution-aware), `uv` install (Python
 bootstrap fallback), `k3s` (service installer).
 
-## Quick start
+## Quick start guide and usage
+
+### Getting started
+
+1. Point the CLI at a registry. Without `--registry`, it searches
+   `$GET_INSTALLER_REGISTRY`, `./registry.json`, and parent dirs.
+2. For an HTTPS registry that needs auth, set `$GET_INSTALLER_TOKEN`
+   (or pass `--auth-token`); it is sent as `Authorization: Bearer <token>`.
+3. Optional: keep those variables in a `KEY=VALUE` file. The CLI loads
+   `--env-file`, else `$GET_INSTALLER_ENV_FILE`, else `./.env` if present.
+
+### Usage
 
 ```bash
 get-installer --list                                # see what's available