update / "Begin Here"

nitya · nitya · commit f518f9022918 · 2025-09-10T23:48:58.000Z
diff --git a/docs/Core-Labs/1-Get-Started/01.md b/docs/Core-Labs/1-Get-Started/01.md
@@ -2,45 +2,51 @@
 
 !!! quote "BY THE END OF THIS LAB YOU SHOULD HAVE"
 
-    - [X] Set your tab preference (Instructor-Led or Self-Guided)
     - [X] Launched GitHub Codespaces (and setup local environment)
+    - [X] Created a personal copy of repo (to make changes & revisit)
     - [X] Provisioned Infrastructure (to get an Azure AI Foundry project)
 
 ---
 
-## Before You Begin
+## 1. Launch GitHub Codespaces
 
-These instructions are setup to support both instructor-led training (in-venue, with pre-provisioned subscription) and self-guided learning (at home, with your subscription). The primary difference will be in the initial setup. 
+1. Navigate to [https://github.com](https://github.com) → login with a personal profile
+1. Navigate to [https://aka.ms/ignite25/preday/prebuild](https://aka.ms/ignite25/preday/prebuild) → you should see this:
 
-**Pick the tab that best represents you right now** ⬇️
+    ![Codespaces Workshop](./../assets/1-codespace-workshop.png)
 
-=== "Instructor-Led (In Venue)"
+1. Click "Create Codespace" → you see a new browser tab with a VS Code IDE
+1. Wait till GitHub Codespaces is loaded and VS Code terminal is ready.
 
-    !!! info "I am currently in the Microsoft Ignite 2025 Pre-Day Workshop (4h Session)"
+!!! success "Your GitHub Codespaces is Ready!"
 
-=== "Self-Guided (At Home)"
+---
 
-    !!! note "I am working through the lab at home, with my subscription (Self-Paced)"
+## 2. Create Personal Fork
 
----
+You are currently in a GitHub Codespaces running on the original repo. In this step, we'll help you make a fork of that repo to your personal profile so you can revisit this later (and save your work).
 
-<!---
-We will provision the AZD "Get Started with AI Agents" template as our infrastructure. These notes correspond to [this commit](https://github.com/nitya/get-started-with-ai-agents/commit/c63e1384ae6a295b3d57378fab02ac4227bf835d) on the AZD template repo. My goal is to document the usage and customization of this template to support various projects - as pre-provisioned infrastructure.
--->
+!!! danger "NITYA-TODO: Grab instructions from Contoso Chat"
 
-## Provision Infrastructure
 
-By the end of this step, you should have an Azure subscription setup with the required resources for this project - which includes an Azure AI Foundry project, AI model deployments, an Azure AI Search service resource - and a default agent with a frontend app.
+---
+
+## 3. Provision Infrastructure
+
+You need an Azure AI Foundry project for this lab, along with supporting Azure resources (e.g., Azure AI Search, App Insights etc.). In this step, we'll streamline that provisioning process by using a custom version of the [_Get Started With AI Agents_](https://ai.azure.com/templates) app template from Azure AI Foundry.
 
 === "Instructor-Led (In Venue)"
 
-    !!! success "You should have a pre-provisioned Azure subscription - check the [Azure Portal](https://portal.azure.com)"
+    - [X] You should have Azure credentials in your Skillable VM
+    - [X] We pre-provisioned infrastructure in this subscription
+
+    !!! success "YOU ARE SET! Let's validate the infrastructure, next."
 
 === "Self-Guided (At Home)"
 
     ??? task "STEP 1: You need to provision the infrastructure - get the template!"
 
-        1. Visit the [Get Started With AI Agents](https://github.com/Azure-Samples/get-started-with-ai-agents) repo 
+        1. Navigate to our [Custom Template](https://aka.ms/ignite25/preday/azd-template) for this lab
         1. Fork it to your profile to get a custom copy (.e., [my fork-branch](https://github.com/nitya/get-started-with-ai-agents/tree/sep2025-pdy123-infra))
         1. Launch GitHub Codespaces on your fork
         1. Wait till the browser VS Code loads - and an active terminal appears.
@@ -111,4 +117,4 @@ By the end of this step, you should have an Azure subscription setup with the re
 
         SUCCESS: Your up workflow to provision and deploy to Azure completed in 11 minutes 50 seconds.
         ```
-    !!! success "You should have a pre-provisioned Azure subscription - check the [Azure Portal](https://portal.azure.com)"
+    !!! success "YOU ARE SET! Let's validate the infrastructure, next."
diff --git a/docs/Core-Labs/assets/1-codespace-workshop.png b/docs/Core-Labs/assets/1-codespace-workshop.png
diff --git a/docs/Core-Labs/assets/2-codespace-template.png b/docs/Core-Labs/assets/2-codespace-template.png
diff --git a/docs/index.md b/docs/index.md
@@ -1,5 +1,5 @@
 ---
-title : "Overview"
+title : "Begin Here"
 description: "PDY123: Learn How To Observe, Manage, and Scale, Agentic AI Apps Using Azure"
 ---
 
@@ -12,15 +12,56 @@ description: "PDY123: Learn How To Observe, Manage, and Scale, Agentic AI Apps U
     **Level:** 300-400 <br/>
     **Duration:** 4 hours
 
-## Application Scenario
+---
+
+## 1. Before You Begin
+
+Before we dive into the workshop, here are two actions you should take:
+
+!!! info "1. STAR THE REPO & WATCH FOR UPDATES"
+
+On completing this workshop, you will walk away with a **personal copy** of the repo that you can use as a sandbox for self-guided exploration. We expect to continue updating this with new labs and resources. Click below to star the repo and watch for updates.
+
+<a class="github-button" href="https://github.com/microsoft/ignite25-PDY123-learn-how-to-observe-manage-and-scale-agentic-ai-apps-using-azure/" data-color-scheme="no-preference: light; light: light; dark: dark;" data-size="large" data-show-count="true" aria-label="Star microsoft/ignite25-PDY123-learn-how-to-observe-manage-and-scale-agentic-ai-apps-using-azure/ on GitHub"> Star This Repo </a>
+
+!!! info "2. PICK YOUR TAB"
+
+The workshop is setup for use by both instructor-led (in-venue) and self-guided (at-home) learners. Select the tab that represents your current status, to get the related instructions. _This preference is automatically enforced sitewide_,
+
+=== "Instructor-Led (In Venue)"
+
+    !!! success "I am at a Microsoft Ignite Session · I'll use the provided Azure subscription."
+
+=== "Self-Guided (At Home)"
+
+    !!! quote "I am working through the lab at home · I'll use my own Azure subscription."
+
+---
+
+## 2. About The Workshop
 
-You are an AI engineer at Zava, an enterprise retail store specializing in home improvement goods for DIY enthusiasts. Your team is building **Cora**, a shopping assistant AI to answer customer queries in-store and online. You have three requirements:
+This is a 4-hour workshop that is broken up into smaller labs that should be completed in order. 
 
-1. Cora's responses must reflect the Zava brand with a custom tone & style
-1. Cora should be cost-effective to deploy given the simple, narrow task
-1. Cora should support end-to-end observability for trustworthy AI operation
+The workshop is organized into two tracks: **Core Labs** that cover the learning objectives outlined below, and **More Labs** that provide additional content for exploration if time permits. _You are encouraged to revisit the More Labs section in self-guided mode, at home_.
 
-## Learning Objectives
+!!! quote "PLANNING ROADMAP FOR CORE LABS"
+
+    ![Plan](./assets/plan.png)
+
+### 2.1 What are we building?
+
+Zava is an enterprise retail store that specializes in home improvement goods for DIY enthusiasts. You are an AI engineer tasked with building **Cora**, the new customer support AI chatbot for Zava customers. 
+
+To unlock business value, Zava sets three requirements:
+
+1. **Be Polite & Helpful** - Cora must respond with a desired tone & style.
+1. **Be Cost-Effective** - Cora should be fast to respond and cheap to operate
+1. **Be Safe & Reliable** - Cora has end-to-end observability for trustworthy AI operation
+
+In this workshop, we'll see how we can start from a basic AI Agent template - and iteratively refine model context and behavior till we get the desired _Cora AI_ experience.
+
+
+### 2.2 What will we learn?
 
 By the end of this session, you will be able to
 
@@ -31,52 +72,31 @@ By the end of this session, you will be able to
 - Trace and monitor chatbot operations to detect & debug performance issues
 - Understand how Azure AI Foundry enables end-to-end observability for AI 
 
-## Session Outline
-
-This 4-hour workshop is organized into "labs" to allow for potential breaks in between.
-
-![Plan](./assets/plan.png)
-
-Each lab is designed to cover a focused topic that you should be able to complete in under 25 minutes. Labs are grouped into two tracks:
-
- - **Core Labs** - these cover the primary objectives for the session
- - **More Labs** - these cover bonus topics or tools for developers
-
-We recommend completing the Core Labs in order, then selecting one or more of the bonus labs to explore if time permits. **By the end of this lab, you will have a personal fork of this repo** - and can revisit and continue learning on your own, with your own Azure subscription.
-
 
-## Pre-Requisites
+### 2.3 Check Pre-Requisites!
 
-To participate in this workshop, you will need:
+=== "Instructor-Led (In Venue)"
 
-1. **A GitHub account**. Create an account for free.
-    - Use a personal account (not enterprise-affiliated)
-    - The free tier of GitHub Codespaces quota is enough
-1. **An Azure subscription**. Create an account for free.
-    - Instructor-led sessions may provide one for you.
-    - Self-guided sessions require you to bring your own.
-1. **Your own laptop**. 
-    - Bring a charger - this is a 4-hour workshop.
-    - Install a modern browser - e.g., Microsoft Edge.
-1. **Familiarity with Coding Environments**
-    - We use Python & Jupyter Notebooks in the labs
-    - We use Visual Studio Code as the editor
+    To be effective in this workshop, you will need:
 
-## Getting Started
+    - [ ] A personal GitHub Account. Sign up [for a free account](https://github.com/signup) if needed.
+    - [ ] Familiarity with Visual Studio Code and Python. This is a hands-on lab.
 
-If you are seeing this instruction guide, you have probably completed these steps:
+    We will provide the following: 
 
-- [X] Forked this repo to your personal profile
-- [X] Launched GitHub Codespaces from your fork
-- [X] Run `mkdocs serve` to get this preview
+    - [X] Powered laptops setup with the labs for your use.
+    - [X] An Azure subscription with pre-provisioned resources.
 
-Now it's time to dive into the workshop. [**Start here**](./Core-Labs/1-Get-Started/01.md) and pick your learning path!
+=== "Self-Guided (At Home)"
 
-## Questions & Feedback
+    To be effective in this workshop, you will need:
 
-Have questions or feedback? 
+    - [ ] A personal GitHub Account. Sign up [for a free account](https://github.com/signup) if needed.
+    - [ ] Familiarity with Visual Studio Code and Python. This is a hands-on lab.
+    - [ ] Your own laptop. Make sure it is fully-charged for a 4-hr session.
+    - [ ] Your own Azure subscription. We'll help you provision the project!
 
-1. [File an issue](https://github.com/microsoft/ignite25-PDY123-learn-how-to-observe-manage-and-scale-agentic-ai-apps-using-azure/issues/new) - to report a bug or errors in documentation
-1. [Join the community](https://aka.ms/foundrydevs) - post to the forum or get help on Discord
+## 3. Let's Get Started 🚀
 
+Click the _Next_ button below - or click on [Core Labs](./Core-Labs/1-Get-Started/01/) in the navigation menu!
 
diff --git a/docs/overrides/main.html b/docs/overrides/main.html
@@ -26,4 +26,7 @@
       background-color: rgba(0, 0, 0, 0.2) !important;
     }
   </style>
+
+  <!-- Place this tag in your head or just before your close body tag. -->
+  <script async defer src="https://buttons.github.io/buttons.js"></script>
 {% endblock %}
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -62,7 +62,7 @@ theme:
   # Theme Features ...............................................
   features:
     - navigation.instant
-    - navigation.expand             # sidebar collapsible sections open
+    - #navigation.expand             # sidebar collapsible sections open
     - navigation.instant.progress   # load progress indicator
     - navigation.tracking           # tracks anchor tags in URL
     - navigation.tabs               # tabbed on desktop, single in mobile    

Original file line number	Diff line number	Diff line change
`@@ -26,4 +26,7 @@`
`26`	`26`	`background-color: rgba(0, 0, 0, 0.2) !important;`
`27`	`27`	`}`
`28`	`28`	`</style>`
	`29`	`+`
	`30`	`+ <!-- Place this tag in your head or just before your close body tag. -->`
	`31`	`+ <script async defer src="https://buttons.github.io/buttons.js"></script>`
`29`	`32`	`{% endblock %}`