update architecture diagram

Author: crpietschmann

06_Provision_Azure_Resources/README.md

@@ -1,16 +1,28 @@
 # Provision Azure resources (Azure Cosmos DB workspace, Azure OpenAI, etc.)
 
-**TBD once all other modules are complete.**
+As the guide walks you through the concepts of integrating vCore-based Azure Cosmos DB for MongoDB and Azure OpenAI, the hands-on labs will also guide you through building a sample solution. The focus of this guide and the labs is limited to vCore-based Azure Cosmos DB for MongoDB, Vector Search, Azure OpenAI, and the Python programming language. With this focus, the labs include an Azure Bicep template that will deploy the following Azure resources the solution will be deployed to:
 
-Bicep deployment is available in the [`deploy` folder of the lab repository](https://github.com/solliancenet/cosmos-db-openai-python-dev-guide-labs/tree/main/deploy).
-Currently deploying the following:
-
-- Resource Group (this is done manually in the Azure Portal)
-- Azure vCore-based Azure Cosmos DB for MongoDB account
-- Azure OpenAI resource
-  - Chat GPT-3.5 `completions` model
+- Azure Resource Group
+- vCore-based Azure Cosmos DB for MongoDB
+- Azure OpenAI
+  - ChatGPT-3.5 `completions` model
   - text-embedding-ada-002 model `embeddings` model
-- Azure Container Registry to host Docker images
-- Azure Container Apps Environment to host Docker containers
-- Azure Container App to run Docker containers (initially with hello-world, but updated during the Backend API lab to run the backend Python API)
-- Azure App Service to host Front-End SPA written in React
+- Azure App Service - for hosting the front-end, static SPA web application written in React
+- Azure Container App - for hosting the back-end, API application written in Python
+- Azure Container Registry - to host Docker images of backend, API application
+
+## Architecture Diagram
+
+![Solution architecture diagram showing how the Azure services deployed are connected](media/architecture.jpg)
+
+Once the Azure resources are provisioned, this guide will walk you through everything that is necessary to build the Back-end API application written in Python.
+
+The Front-end Web App is a static SPA application written in React. Since React is outside the scope of this guide, the Front-end Web App is pre-built for you and will be configured automatically on deployment. You do not need any experience with React in order to complete the labs in this guide.
+
+## Lab - Provision Azure Resources
+
+This lab will walk you through deploying the Azure resources necessary for the solution built in this guide. The deployment will be done using an Azure Bicep template that is configured to provision all the necessary resources.
+
+> **Note**: You will need an Azure Subscription and have the necessary permissions to provision the Azure resources.
+
+Please visit the lab repository to complete [this lab](https://github.com/solliancenet/cosmos-db-openai-python-dev-guide-labs/blob/main/deploy/deploy.md).

06_Provision_Azure_Resources/media/architecture.jpg

@@ -1,7 +1,5 @@
-# cosmos-db-openai-python-dev-guide
-Azure Cosmos DB + Azure OpenAI Python developer guide
+# Azure Cosmos DB + Azure OpenAI Python developer guide
 
+## Architecture Diagram
 
-# Architecture
-
-![Architecture Diagram](assets/architecture.jpg)
+![Architecture Diagram](06_Provision_Azure_Resources/media/architecture.jpg)