Enhance homepage intro and rename Context to Backstory

artvandelay · artvandelay · commit 0a8f995465eb · 2025-10-08T06:10:20.000+05:30
- Add 2 sentences explaining the guide bridges theory/practice via 100k+ lines analysis
- Emphasize battle-tested production system and immediate runnable exercises
- Rename 'Context' to 'Backstory' in navigation for clearer messaging
- More compelling intro that highlights unique value proposition
diff --git a/docs/context.md b/docs/context.md
@@ -1,4 +1,4 @@
-# Context: How This Book Came to Be
+# Backstory: How This Book Came to Be
 
 ## The Backstory
 
diff --git a/docs/index.md b/docs/index.md
@@ -2,6 +2,8 @@
 
 Learn to build production AI agents through real-world patterns extracted from OpenAI Codex CLI.
 
+This guide bridges theory and practice by analyzing 100,000+ lines of production Rust code from OpenAI's battle-tested agent system. Each pattern includes Python implementations, real-world examples, and hands-on exercises you can run immediately.
+
 ## Chapters
 
 **[Chapter 1 - Prompt Chaining](./learning-material/01-prompt-chaining/README.md)**  
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -119,7 +119,7 @@ validation:
 
 nav:
   - Home: index.md
-  - Context: context.md
+  - Backstory: context.md
   - Chapter 1 - Prompt Chaining: learning-material/01-prompt-chaining/README.md
   - Chapter 2 - Routing: learning-material/02-routing/README.md
   - Chapter 3 - Parallelization: learning-material/03-parallelization/README.md

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Context: How This Book Came to Be`
	`1`	`+# Backstory: How This Book Came to Be`
`2`	`2`
`3`	`3`	`## The Backstory`
`4`	`4`