updated / overview

Author: nitya

SUPPORT.md

@@ -1,25 +1,22 @@
-# TODO: The maintainer of this repo has not yet edited this file
+# Support
 
-**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
+## How to file issues and get help  
 
-- **No CSS support:** Fill out this template with information about how to file issues and get help.
-- **Yes CSS support:** Fill out an intake form at [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS will work with/help you to determine next steps.
-- **Not sure?** Fill out an intake as though the answer were "Yes". CSS will help you decide.
+This project uses GitHub Issues to track bugs and feature requests. 
 
-*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
+1. Search existing 
+issues before filing new issues to avoid duplicates.  
+1. For new issues, file your bug or 
+feature request as a [new Issue](https://github.com/microsoft/ignite25-PDY123-learn-how-to-observe-manage-and-scale-agentic-ai-apps-using-azure/issues/new).
 
-# Support
+## Ask The Community
 
-## How to file issues and get help  
+Want to explore other avenues for help? Join our vibrant [Azure AI Foundry community](https://aka.ms/foundrydevs) and get help from your peers and subject matter experts.
 
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
-issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
-feature request as a new Issue.
+[![Microsoft Azure AI Foundry Discord](https://dcbadge.limes.pink/api/server/ByRwuEEgH4)](https://discord.com/invite/ByRwuEEgH4)
+[![Azure AI Foundry Developer Forum](https://img.shields.io/badge/GitHub-Azure_AI_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=adff2f&logoColor=fff)](https://aka.ms/foundry/forum)
 
-For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
-FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
-CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
 
 ## Microsoft Support Policy  
 
-Support for this **PROJECT or PRODUCT** is limited to the resources listed above.
+Support for this project is limited to the resources listed above.

docs/index.md

@@ -47,8 +47,36 @@ We recommend completing the Core Labs in order, then selecting one or more of th
 
 ## Pre-Requisites
 
+To participate in this workshop, you will need:
+
+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
+
 ## Getting Started
 
+If you are seeing this instruction guide, you have probably completed these steps:
+
+- [X] Forked this repo to your personal profile
+- [X] Launched GitHub Codespaces from your fork
+- [X] Run `mkdocs serve` to get this preview
+
+Now it's time to dive into the workshop. [**Start here**](./Core-Labs/1-Get-Started/01.md) and pick your learning path!
+
 ## Questions & Feedback
 
+Have questions or feedback? 
+
+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
+
 

lab/README.md

@@ -1,31 +1,66 @@
+<p align="center">
+<img src="./../docs/assets/Banner-ignite-25.png" alt="decorative banner" width="1200"/>
+</p>
 
+# Learn how to observe, manage, and scale agentic AI apps using Azure
 
-These instructions are for participants of the **instructor-led** Workshop "SESSIONNAME" at Microsoft AI Tour 2026.  Register to attend in a city near you at [Microsoft AI Tour](https://aitour.microsoft.com/).
+These instructions are for _participants_ of the above instructor-led pre-day workshop at Microsoft Ignite 2025.
 
 ## Lab Overview
 
-In this hands-on workshop, you’ll learn to ....
+This hands-on workshop will provide participants with the skills to effectively manage, govern, and scale agentic AI applications using Azure and Azure AI Foundry. The session will cover observability capabilities, model management policies, agent functionalities, and governance strategies. Participants will engage in practical exercises to apply these concepts in real-world scenarios.
 
-If you're not a workshop participant at AI Tour, try this code yourself at ....
+- Level: 300-400
+- Duration: 4 hours
 
 ## Pre-Requisites
 
 To participate in this workshop, you will need:
 
-1. Your own laptop.
-   * It need only be capable of running a browser and GitHub Codespaces, so almost any laptop will do.
-   * A recent version of Edge, Chrome or Safari is recommended.
-2. Prerequisite #2
-3. Prerequisite #3
+1. **A GitHub account**. We recommend you have a personal account (not one affiliated with an enterprise).
+   - Create one if needed. It's free and fast to setup.
+   - The free tier of GitHub Codespaces is sufficient.
+1. **An Azure subscription** to provision infrastructure.
+   - Instructor-led events will provide one for you
+   - Self-guided sessions require you to have your own
+1. **Your own laptop**. 
+   - Bring your charger. This is a 4hr workshop.
+   - Install a modern browser. We recommend Microsoft Edge.
+1. **Familiarity with Python**
+   - We will work with Python code in Jupyter Notebooks
+   - We use Visual Studio Code as the editor
+1. **Familiarity with Azure**
+   - We will use the Azure Portal to validate resources
+   - We will use Azure AI Foundry to work with AI projects
+   - We will use Azure AI SDKs (Python) for various tasks
 
 ## Get Started
 
-To get started you will need to
+To get started, follow these steps:
+
+1. **Fork The Repo**
+   - Log into GitHub with your personal profile.
+   - Fork the repo (main branch is sufficient)
+   - You now have a sandbox to explore after the session
+1. **Launch Codespaces**
+   - Open your fork in the browser.
+   - Click the `Code` button and select `Codespaces` tab
+   - Click the `+` and create a new Codespace instance
+1. **Wait For Terminal** 
+   - a new browser tab opens with a VS Code editor
+   - wait till the Codespace is ready & terminal is live
+1. **Launch Instruction Guide**
+   - type `mkdocs serve > /dev/null 2>&1 &` in terminal
+   - this launches a preview server in background 
+   - you will see a popup - select open browser 
+   - OR go to Ports - select 8000 and open browser
+
+You should see a preview of the instruction guide in the browser. Read the Overview - then follow the _Getting Started_ directions on that page.
 
 ## Discussions
 
 Build your first agent with Azure AI Agent Service is an open source project supported by Microsoft. See the [SUPPORT.md](../SUPPORT.md) file for details on how to raise issues or contribute. If you enjoyed this workshop please give the repository a ⭐ and share it with others.
 
 ## Source code
 
-The source code for this session can be found in the [src folder](../src) of this repo.
+The labs for this session are stored in Jupyter notebooks under the `lab/` folder. Follow the instructions to _Get Started_ to launch a preview of our instruction guide - to learn how to use these labs effectively.