docs: sync presentation outline with walkthrough and add first-class parameters

Update presentation materials to be fully synced with the mdBook walkthrough:

PRESENTATION_OUTLINE.md:
- Add note directing to walkthrough as primary presentation source
- Add walkthrough links to each section for easy navigation
- Keep outline as speaker notes, timing guide, and Q&A prep

docs/src/walkthrough/02-solution.md:
- Update examples to showcase first-class parameters
- Add metrics: 225 tests, first-class parameters feature
- Update version: v0.6.5 → v0.6.6

docs/src/walkthrough/05-human-friendly.md:
- Add new "First-Class Parameters" section at the top
- Show before/after comparison (70% typing reduction)
- Update all database creation examples to use clean CLI flags
- Keep JSON examples as alternative for complex configs
- Update --wait examples with new syntax

This ensures consistency between all presentation materials and makes the
walkthrough the single source of truth for content while keeping the outline
useful for speaker preparation.

Author: joshrotenberg

docs/src/walkthrough/02-solution.md

@@ -20,8 +20,16 @@ A unified CLI that eliminates fragile bash scripts with:
 curl + jq + while loops + manual polling + text parsing
 ```
 
-**After: One Command**
+**After: One Simple Command**
 ```bash
+# Clean CLI with first-class parameters (v0.6.6+)
+redisctl cloud database create \
+  --subscription 12345 \
+  --name mydb \
+  --memory 1 \
+  --wait
+
+# Or use JSON for complex configs
 redisctl cloud database create \
   --subscription 12345 \
   --data '{"name": "mydb", "memoryLimitInGb": 1}' \
@@ -48,9 +56,11 @@ redisctl cloud database create \
 ## Metrics
 
 - 50+ API handlers (21 Cloud + 29 Enterprise)
+- 225 comprehensive CLI tests (+217% coverage increase)
 - 85%+ test coverage
+- First-class parameters for common operations
 - Cross-platform (macOS, Linux, Windows)
-- v0.6.5 released and actively maintained
+- v0.6.6 released and actively maintained
 
 ## The Impact
 

docs/src/walkthrough/05-human-friendly.md

@@ -6,6 +6,31 @@
 
 Better experience for day-to-day operations with type-safe parameters, automatic error handling, and progress indicators.
 
+## First-Class Parameters (v0.6.6+)
+
+**Before: JSON strings required**
+```bash
+# Old way - easy to mess up!
+redisctl enterprise database create \
+  --data '{"name":"mydb","memory_size":1073741824,"replication":true}'
+```
+
+**After: Clean CLI parameters**
+```bash
+# New way - simple and validated
+redisctl enterprise database create \
+  --name mydb \
+  --memory 1073741824 \
+  --replication
+```
+
+**Key improvements:**
+- 70% less typing for common operations
+- No JSON syntax errors
+- Tab completion works
+- Better error messages
+- Still supports `--data` for complex configs
+
 ## Cloud Operations
 
 ```bash
@@ -34,7 +59,14 @@ redisctl enterprise cluster get \
 redisctl enterprise database list \
   -o json -q '[].{uid: uid, name: name, port: port, status: status}'
 
-# Create database (as shown in docker-compose)
+# Create database - clean CLI parameters
+redisctl enterprise database create \
+  --name cache-db \
+  --memory 104857600 \
+  --port 12001 \
+  -o json -q '{uid: uid, name: name, port: port, status: status}'
+
+# Or with JSON for complex configs
 redisctl enterprise database create \
   --data '{"name": "cache-db", "memory_size": 104857600, "port": 12001}' \
   -o json -q '{uid: uid, name: name, port: port, status: status}'
@@ -70,7 +102,14 @@ redisctl enterprise database get 1 -o yaml
 The `--wait` flag automatically polls until operations complete:
 
 ```bash
-# Create and wait for completion
+# Create and wait for completion - new clean syntax
+redisctl cloud database create \
+  --subscription 12345 \
+  --name mydb \
+  --memory 1 \
+  --wait
+
+# Or with JSON for complex configs
 redisctl cloud database create \
   --subscription 12345 \
   --data '{"name": "mydb", "memoryLimitInGb": 1}' \

examples/presentation/PRESENTATION_OUTLINE.md

@@ -4,10 +4,16 @@
 **Audience:** Technical team (engineers, architects)
 **Goal:** Introduce redisctl as the first CLI tool for Redis management
 
+> **📖 Primary Presentation Source:** Use `docs/src/walkthrough/` (mdBook) for the actual presentation.  
+> This outline provides speaker notes, timing, and Q&A preparation.  
+> The walkthrough is navigable, polished, and keeps content synced in one place.
+
 ---
 
 ## 1. Current State of Redis Management (3 min)
 
+> **📖 Walkthrough:** [1. The Problem](../../docs/src/walkthrough/01-problem.md)
+
 ### Redis Cloud
 - REST API exists but not widely used directly
 - Primary interfaces:
@@ -43,6 +49,8 @@
 
 ## 2. Enter redisctl (2 min)
 
+> **📖 Walkthrough:** [2. Enter redisctl](../../docs/src/walkthrough/02-solution.md)
+
 **The FIRST command-line tool for both Redis Cloud and Redis Enterprise**
 
 ### Key Value Propositions
@@ -61,6 +69,8 @@
 
 ## 3. Installation & Setup (2 min)
 
+> **📖 Walkthrough:** [3. Installation & Setup](../../docs/src/walkthrough/03-setup.md)
+
 ### Installation
 
 ```bash
@@ -103,6 +113,8 @@ redisctl profile list
 
 ## 4. Four-Layer Architecture (5 min)
 
+> **📖 Walkthrough:** [4. Raw API](../../docs/src/walkthrough/04-raw-api.md) → [5. Human-Friendly](../../docs/src/walkthrough/05-human-friendly.md) → [6. Workflows](../../docs/src/walkthrough/06-workflows.md) → [7. Advanced](../../docs/src/walkthrough/07-advanced.md)
+
 ### Layer 1: Raw API Access
 
 **Use case:** Any endpoint, full control
@@ -233,6 +245,8 @@ ls -lh demo-package*.tar.gz
 
 ## 5. Recent UX Improvements (3 min)
 
+> **📖 Walkthrough:** [5. Human-Friendly Commands](../../docs/src/walkthrough/05-human-friendly.md) (First-Class Parameters section)
+
 ### First-Class Parameters (NEW in v0.6.6)
 
 **The Problem with JSON strings:**
@@ -361,6 +375,8 @@ redisctl enterprise license set --key "license-string"
 
 ## 7. rladmin Comparison (2 min)
 
+> **📖 Walkthrough:** [Appendix: rladmin Comparison](../../docs/src/walkthrough/rladmin-comparison.md)
+
 **Quick comparison:** (Show `RLADMIN_COMPARISON.md`)
 
 ### Where redisctl Excels Over rladmin
@@ -382,6 +398,8 @@ redisctl enterprise license set --key "license-string"
 
 ## 8. Library Architecture (2 min)
 
+> **📖 Walkthrough:** [8. Library Architecture](../../docs/src/walkthrough/08-libraries.md)
+
 **redisctl isn't just a CLI - it's a platform**
 
 ### Current Libraries
@@ -464,6 +482,8 @@ Showcases:
 
 ## 11. Roadmap & Future (2 min)
 
+> **📖 Walkthrough:** [9. Next Steps](../../docs/src/walkthrough/09-next-steps.md)
+
 ### Near Term
 - Additional workflows (see issues #263-#268)
 - Enhanced streaming (metrics, events - #405)