From 19dcdf4aedd20c8800558f186bdf27794a7aee11 Mon Sep 17 00:00:00 2001 From: Jon Galloway Date: Fri, 17 Jul 2026 16:29:54 -0700 Subject: [PATCH 1/3] docs: begin #503 flow alignment in workshop guides Update root module sequence to the new converged path and mark advanced MCP parts as optional/bonus. Also update Part 1 Next Steps to point to Part 2 Build Chat App. --- Part 1 - Setup/README.md | 2 +- README.md | 16 +++++++++------- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/Part 1 - Setup/README.md b/Part 1 - Setup/README.md index e861f5c..8400757 100644 --- a/Part 1 - Setup/README.md +++ b/Part 1 - Setup/README.md @@ -115,7 +115,7 @@ If you don't already have a GitHub account, follow these steps to create one: Ready to build your first AI application? Let's get started! -**Continue to** → [Part 2: Create a Project with AI Web Chat Template](../Part%202%20-%20Project%20Creation/README.md) +**Continue to** → [Part 2: Build Chat App](../Part%202%20-%20Build%20Chat%20App/README.md) In Part 2, you'll learn how to: diff --git a/README.md b/README.md index 49eaa18..7dba0a9 100644 --- a/README.md +++ b/README.md @@ -141,19 +141,21 @@ Follow the [setup instructions](Part%201%20-%20Setup/README.md) to get started w ## Lab Modules 📚 -The lab is divided into nine modules: +The lab is divided into nine modules. + +The primary sequence below reflects the current converged workshop flow and keeps advanced modules explicitly optional for pacing. ### AI Web Chat Application (Parts 1-6) 1. 🏗️ [**Setup**](Part%201%20-%20Setup/README.md): Configure prerequisites and development environment for the AI workshop. -2. 🏗️ [**Project Creation**](Part%202%20-%20Project%20Creation/README.md): Build a web application using the .NET AI Web Chat template. +2. 💬 [**Build Chat App**](Part%202%20-%20Build%20Chat%20App/README.md): Build and run a minimal console-based AI chat app. -3. 🔍 [**Template Exploration**](Part%203%20-%20Template%20Exploration/README.md): Understand the implementation of vector embeddings, semantic search, and chat interfaces in AI Web Chat projects. +3. 🧩 [**Add RAG**](Part%203%20-%20Add%20RAG/README.md): Add retrieval-augmented generation with embeddings and semantic search. -4. ☁️ [**Azure OpenAI**](Part%204%20-%20Azure%20OpenAI/README.md): Transition from GitHub Models to the Azure OpenAI service for production-ready capabilities. +4. 🔍 [**Template Reveal**](Part%204%20-%20Template%20reveal/README.md): Compare your manual implementation with the generated template architecture. -5. 🛍️ [**Products Page**](Part%205%20-%20Products%20Page/README.md): Implement a product catalog that leverages AI for enhanced product information. +5. 🔁 [**Providers and Fallbacks**](Part%205%20-%20Providers%20and%20Fallbacks/README.md): Configure provider options and fallback paths (Azure AI Foundry primary). 6. 🚀 [**Deployment**](Part%206%20-%20Deployment/README.md): Deploy your application to Azure using the Azure Developer CLI. @@ -161,9 +163,9 @@ The lab is divided into nine modules: 1. 🔧 [**MCP Server Basics**](Part%207%20-%20MCP%20Server%20Basics/README.md): Create your first MCP server with weather tools that extend AI agents like GitHub Copilot. -2. 🏢 [**Enhanced MCP Server**](Part%208%20-%20Enhanced%20MCP%20Server/README.md): Build sophisticated business tools for order management, inventory, and customer service scenarios. +2. 🏢 [**Enhanced MCP Server**](Part%208%20-%20Enhanced%20MCP%20Server/README.md) *(Optional / bonus)*: Build sophisticated business tools for order management, inventory, and customer service scenarios. -3. 📦 [**MCP Publishing**](Part%209%20-%20MCP%20Publishing/README.md): Package, publish, and distribute your MCP servers through NuGet for professional deployment. +3. 📦 [**MCP Publishing**](Part%209%20-%20MCP%20Publishing/README.md) *(Optional / bonus)*: Package, publish, and distribute your MCP servers through NuGet for professional deployment. ## Lab Structure 📁 From 1cdfe810f8f9a6239584e35142d4f57ab79215ec Mon Sep 17 00:00:00 2001 From: Jon Galloway Date: Fri, 17 Jul 2026 16:49:01 -0700 Subject: [PATCH 2/3] docs: rename Part 4 label to AI Web Chat Template Use learner-facing wording in the root module list instead of internal storytelling terminology. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7dba0a9..623f04c 100644 --- a/README.md +++ b/README.md @@ -153,7 +153,7 @@ The primary sequence below reflects the current converged workshop flow and keep 3. 🧩 [**Add RAG**](Part%203%20-%20Add%20RAG/README.md): Add retrieval-augmented generation with embeddings and semantic search. -4. 🔍 [**Template Reveal**](Part%204%20-%20Template%20reveal/README.md): Compare your manual implementation with the generated template architecture. +4. 🔍 [**AI Web Chat Template**](Part%204%20-%20Template%20reveal/README.md): Compare your manual implementation with the generated template architecture. 5. 🔁 [**Providers and Fallbacks**](Part%205%20-%20Providers%20and%20Fallbacks/README.md): Configure provider options and fallback paths (Azure AI Foundry primary). From f36df85c9402ea734a58ac92daa492488c5d1792 Mon Sep 17 00:00:00 2001 From: Jon Galloway Date: Fri, 17 Jul 2026 16:58:22 -0700 Subject: [PATCH 3/3] docs: replace remaining 'Template reveal' wording Use learner-facing term 'AI Web Chat Template' in Part 4 title. --- Part 4 - Template reveal/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Part 4 - Template reveal/README.md b/Part 4 - Template reveal/README.md index ae4b2bc..b8eee5c 100644 --- a/Part 4 - Template reveal/README.md +++ b/Part 4 - Template reveal/README.md @@ -1,4 +1,4 @@ -# Part 4: Template reveal — scaffold `aichatweb` and understand the code +# Part 4: AI Web Chat Template — scaffold `aichatweb` and understand the code You've now built a chat app (Part 2) and a RAG loop (Part 3) **by hand**. You know what an `IChatClient` is, what an embedding is, what a vector search does, and why