docs: fix brew tap command and set mdbook folding to closed by default

- Change brew tap from joshrotenberg/tap to joshrotenberg/brew
- Set mdbook fold level to 0 (closed by default)

Author: joshrotenberg

docker-compose.yml

@@ -13,7 +13,7 @@ edit-url-template = "https://github.com/joshrotenberg/redisctl/edit/main/docs/{p
 
 [output.html.fold]
 enable = true
-level = 1
+level = 0
 
 # Temporarily disabled for reorganization
 # [preprocessor.lint]

docs/book.toml

@@ -4,32 +4,32 @@
 
 ## Redis Cloud
 
-### What Exists
-- 🖱️ **Web UI** - Point and click (not scriptable)
-- 🏗️ **Terraform Provider** - Good for IaC, not ad-hoc operations
-- 🌐 **REST API** - Documented but no tooling around it
+**What Exists:**
+- Web UI - Point and click (not scriptable)
+- Terraform Provider - Good for IaC, not ad-hoc operations
+- REST API - Documented but no tooling around it
 
-### The Gap
-❌ No CLI for day-to-day operations  
-❌ No way to script common tasks  
-❌ Must use UI or write custom bash scripts
+**The Gap:**
+- No CLI for day-to-day operations
+- No way to script common tasks
+- Must use UI or write custom bash scripts
 
 ## Redis Enterprise
 
-### What Exists
-- 🖥️ **rladmin** - Powerful but limited
+**What Exists:**
+- **rladmin** - Powerful but limited
   - Must SSH to cluster nodes
   - Text output (hard to parse)
   - Not cross-platform (Linux only on nodes)
   - Single cluster at a time
-- 🌐 **REST API** - Large (~100+ endpoints), poorly documented
+- **REST API** - Large (~100+ endpoints), poorly documented
   - Manual JSON construction
   - No official tooling
 
-### The Gap
-❌ No remote management CLI  
-❌ No automation-friendly tools  
-❌ No multi-cluster support
+**The Gap:**
+- No remote management CLI
+- No automation-friendly tools
+- No multi-cluster support
 
 ## The Reality
 
@@ -47,38 +47,23 @@ curl -X POST https://api.redislabs.com/v1/subscriptions \
 while true; do
   STATUS=$(curl -s https://api.redislabs.com/v1/tasks/$TASK_ID | jq -r '.status')
   if [ "$STATUS" = "completed" ]; then break; fi
-  echo "Still waiting..."
   sleep 2
 done
-
-# Then create database...
-# Poll again...
-# Repeat for every operation...
 ```
 
-## Problems with This Approach
-
-1. ❌ **No type safety** - Typos cause runtime failures
-2. ❌ **Manual JSON** - Error-prone, hard to maintain
-3. ❌ **Polling loops** - Fragile, need manual error handling
-4. ❌ **Credential exposure** - API keys in shell history
-5. ❌ **Not portable** - Requires bash, curl, jq
-6. ❌ **No progress feedback** - Silent failures
-7. ❌ **Everyone reinvents** - Same scripts written over and over
+## Problems
 
-## Who This Affects
-
-- **Support Engineers** → Manual UI clicking, can't script diagnostics
-- **DevOps Teams** → Can't automate without Terraform
-- **Customers** → Build fragile bash scripts or don't automate
-- **Everyone** → Wastes time on operations that should be simple
+1. No type safety - Typos cause runtime failures
+2. Manual JSON - Error-prone, hard to maintain
+3. Polling loops - Fragile, need manual error handling
+4. Credential exposure - API keys in shell history
+5. Not portable - Requires bash, curl, jq
+6. No progress feedback - Silent failures
 
 ## The Core Problem
 
 **Redis had ZERO command-line tools for Cloud or Enterprise management**
 
 ---
 
-**Next →** [2. Enter redisctl](./02-solution.md) - The first CLI tool
-
-**Demo:** Run `examples/presentation/01-before-redisctl.sh` to see this in action
+**Next:** [2. Enter redisctl](./02-solution.md)

docs/src/walkthrough/01-problem.md

@@ -6,68 +6,63 @@
 
 A unified CLI that eliminates fragile bash scripts with:
 
-✅ Type-safe API clients  
-✅ Automatic async operation handling  
-✅ Support package automation  
-✅ Profile management with secure keyring  
-✅ Structured output (JSON, YAML, Table)  
-✅ Library-first architecture
+- Type-safe API clients
+- Automatic async operation handling
+- Support package automation
+- Profile management with secure keyring
+- Structured output (JSON, YAML, Table)
+- Library-first architecture
 
 ## Before vs After
 
-### Before: 50 Lines of Bash
-
+**Before: 50 Lines of Bash**
 ```bash
 curl + jq + while loops + manual polling + text parsing
 ```
 
-### After: One Command
-
+**After: One Command**
 ```bash
 redisctl cloud database create \
-  --subscription-id 12345 \
+  --subscription 12345 \
   --data '{"name": "mydb", "memoryLimitInGb": 1}' \
   --wait
 ```
 
 ## Key Benefits
 
-### For Support Engineers
-- ✅ Remote cluster management (no SSH)
-- ✅ Support package automation (10 min → 30 sec)
-- ✅ Scriptable diagnostics
+**Support Engineers:**
+- Remote cluster management (no SSH)
+- Support package automation (10 min to 30 sec)
+- Scriptable diagnostics
 
-### For DevOps Teams
-- ✅ CI/CD integration (JSON output)
-- ✅ Multi-cluster management (profiles)
-- ✅ Automation-friendly
+**DevOps Teams:**
+- CI/CD integration (JSON output)
+- Multi-cluster management (profiles)
+- Automation-friendly
 
-### For Developers
-- ✅ Reusable libraries
-- ✅ Type-safe API clients
-- ✅ Build custom tools
+**Developers:**
+- Reusable libraries
+- Type-safe API clients
+- Build custom tools
 
 ## Metrics
 
-- **50+ API handlers** (21 Cloud + 29 Enterprise)
-- **85%+ test coverage** (production quality)
-- **Cross-platform** (macOS, Linux, Windows)
-- **v0.6.5** released and actively maintained
+- 50+ API handlers (21 Cloud + 29 Enterprise)
+- 85%+ test coverage
+- Cross-platform (macOS, Linux, Windows)
+- v0.6.5 released and actively maintained
 
 ## The Impact
 
 **One command replaces 50 lines of fragile bash**
 
 ```bash
-# Everything just works
 redisctl cloud subscription list
-redisctl enterprise database list -o table
+redisctl enterprise database list
 redisctl enterprise support-package cluster --upload
 ```
 
 ---
 
-**← Previous:** [1. The Problem](./01-problem.md)  
-**Next →** [3. Installation & Setup](./03-setup.md)
-
-**Demo:** Run `examples/presentation/02-after-redisctl.sh` to see the difference
+**Previous:** [1. The Problem](./01-problem.md)  
+**Next:** [3. Installation & Setup](./03-setup.md)

docs/src/walkthrough/02-solution.md

@@ -2,98 +2,94 @@
 
 ## Installation
 
-### Homebrew (macOS/Linux)
-
+**Homebrew (macOS/Linux):**
 ```bash
-brew install joshrotenberg/brew/redisctl
+brew tap joshrotenberg/brew
+brew install redisctl
 ```
 
-### GitHub Releases
-
-Download pre-built binaries for your platform:
-- macOS (Intel & Apple Silicon)
-- Linux (x86_64)
-- Windows (x86_64)
-
-[→ Latest Release](https://github.com/joshrotenberg/redisctl/releases)
-
-### Docker
+**GitHub Releases:**  
+Download pre-built binaries: [Latest Release](https://github.com/joshrotenberg/redisctl/releases)
 
+**Docker:**
 ```bash
 docker run ghcr.io/joshrotenberg/redisctl:latest --help
 ```
 
-### Cargo (from source)
-
+**Cargo (from source):**
 ```bash
 cargo install redisctl
 ```
 
 ## Profile Setup
 
-### Why Profiles?
-
-Profiles let you:
-- Manage multiple clusters (dev, staging, prod)
-- Store credentials securely (OS keyring)
-- Override with env vars or CLI flags
-
-### Cloud Profile
+Profiles let you manage multiple clusters (dev, staging, prod) and store credentials securely.
 
+**Cloud Profile:**
 ```bash
-redisctl profile set prod-cloud \
-  --deployment-type cloud \
+redisctl profile set prod --deployment cloud \
   --api-key "your-api-key" \
-  --api-secret "your-secret-key" \
-  --use-keyring
+  --api-secret "your-secret-key"
 ```
 
-### Enterprise Profile
-
+**Enterprise Profile:**
 ```bash
-redisctl profile set prod-cluster \
-  --deployment-type enterprise \
-  --url "https://cluster.example.com:9443" \
-  --username "[email protected]" \
-  --use-keyring
-# Password will be prompted and stored securely
+redisctl profile set local --deployment enterprise \
+  --url https://localhost:9443 \
+  --username [email protected] \
+  --password Redis123! \
+  --insecure
 ```
 
-### Verify Setup
-
+**List Profiles:**
 ```bash
-# List profiles
 redisctl profile list
-
-# Test connection
-redisctl api cloud get /           # Cloud
-redisctl api enterprise get /v1/cluster  # Enterprise
 ```
 
-## Secure Credential Storage
+**Use a Profile:**
+```bash
+# With flag
+redisctl -p prod cloud subscription list
 
-With `--use-keyring`:
-- **macOS**: Keychain
-- **Windows**: Credential Manager
-- **Linux**: Secret Service
+# With environment variable
+export REDISCTL_PROFILE=prod
+redisctl cloud subscription list
+```
 
-No credentials in config files or shell history!
+## Credential Storage
 
-## Override Hierarchy
+**Plaintext** (default) - Stored in config.toml
 
+**Environment Variables:**
+```bash
+export REDIS_CLOUD_API_KEY="your-key"
+export REDIS_CLOUD_SECRET_KEY="your-secret"
 ```
-CLI flags > Environment variables > Profile settings
+
+**OS Keyring** (requires `secure-storage` feature):
+```bash
+redisctl profile set prod --deployment cloud \
+  --api-key "$KEY" \
+  --api-secret "$SECRET" \
+  --use-keyring
 ```
 
-Example:
+## Docker Compose Demo
+
+Try the complete Enterprise demo:
+
 ```bash
-# Override profile URL for one command
-redisctl --url https://other-cluster:9443 enterprise cluster get
+git clone https://github.com/joshrotenberg/redisctl
+cd redisctl
+docker compose up -d
+
+# Watch initialization
+docker compose logs -f redis-enterprise-init
 ```
 
----
+See `docker-compose.yml` for annotated examples of every command type.
 
-**← Previous:** [2. Enter redisctl](./02-solution.md)  
-**Next →** [4. Raw API Layer](./04-raw-api.md)
+---
 
-See [Configuration Guide](../getting-started/configuration.md) for details
+**Previous:** [2. Enter redisctl](./02-solution.md)  
+**Next:** [4. Raw API Access](./04-raw-api.md)