more notes on the lab steps (#177)

## Purpose

add more notes

## Does this introduce a breaking change?
<!-- Mark one with an "x". -->
```
[ ] Yes
[x] No
```

## Pull Request Type
What kind of change does this Pull Request introduce?

<!-- Please check the one that applies to this PR using "x". -->
```
[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Documentation content changes
[x] Other... Please describe:
```

---------

Co-authored-by: Tycen Hopkins <[email protected]>

Author: sonwan2020

docs/02_lab_launch/0202.md

@@ -20,6 +20,7 @@ This involves three things:
 
 ## Step-by-step guidance
 
+
 1.  Run the following commands to create a resource group, which you’ll use for all subsequent resources that you’ll create in this lab. Replace the \<*azure-region*\> placeholder with the name of the Azure region you want to use:
 
     ```bash
@@ -63,7 +64,12 @@ This involves three things:
     SUBNET_ID=$(az network vnet subnet show --resource-group $RESOURCE_GROUP --vnet-name $VIRTUAL_NETWORK_NAME --name aca-subnet --query id -o tsv)
     ```
 
-1.  Create a new Azure Container Apps environment in your resource group, and configure it to use the new subnet. We’ll be creating the service on an [Azure Container Apps Dedicated plan](https://learn.microsoft.com/azure/container-apps/plans#dedicated) using the [workload profiles](https://learn.microsoft.com/azure/container-apps/workload-profiles-overview) option. This plan gives you more advanced features than the alternative [Azure Container Apps Consumption plan](https://learn.microsoft.com/azure/container-apps/plans#consumption) type:
+1.  Create a new Azure Container Apps environment in your resource group, and configure it to use the new subnet. 
+
+    {: .note}
+    > If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), you can skip this step.
+
+    We’ll be creating the service on an [Azure Container Apps Dedicated plan](https://learn.microsoft.com/azure/container-apps/plans#dedicated) using the [workload profiles](https://learn.microsoft.com/azure/container-apps/workload-profiles-overview) option. This plan gives you more advanced features than the alternative [Azure Container Apps Consumption plan](https://learn.microsoft.com/azure/container-apps/plans#consumption) type:
 
     ```bash
     ACA_ENVIRONMENT=acalab-env-$APPNAME-$UNIQUEID
@@ -90,4 +96,4 @@ This involves three things:
         > If you don't immediately find the Container Apps environment in the resource group overview list, wait a moment and then select `Refresh` a few times until it appears.
 
         {: .note }
-        > You may also notice an additional resource group (beginning with “ME_”) in your subscription. This resource group, which you created in this set of steps, will also contain any associated resources created to support the Container Apps environment and virtual network.
+        > You may also notice an additional resource group (beginning with “ME_”) in your subscription. This resource group, which you created in this set of steps, will also contain any associated resources created to support the Container Apps environment and virtual network.

docs/02_lab_launch/0203.md

@@ -16,6 +16,9 @@ By default, the MySQL database you create will have a firewall enabled that will
 
 ## Step-by-step guidance
 
+{: .note}
+> If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), skip to step 2.
+
 1.  To create an Azure Database for MySQL - Flexible Server instance, run the following commands. Replace the \<*sqladmin-password*\> placeholder with a complex password, and record its value.
 
     {: .note }

docs/02_lab_launch/0206.md

@@ -13,8 +13,13 @@ To give your Container Apps environment secure access to the container registry,
 
 ## Step-by-step guidance
 
+{: .note}
+> If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), skip to step 2.
+
 1.  Create a container registry instance to build and save your container images.
 
+    Note: Skip this step if ./tools/create-azure-resources.sh runs succeed.
+
     ```bash
     MYACR=acr$APPNAME$UNIQUEID
     az acr create \

docs/03_lab_openai/0301.md

@@ -9,8 +9,8 @@ parent: 'Lab 3: Integrate Azure OpenAI Service with your apps'
 
 Before you can add AI capabilities to your application, you need to create an Azure OpenAI account and deploy the language models that you want to use.
 
-{: .note }
-> If you already have valid `AZURE-OPENAI-ENDPOINT` and `AZURE-OPENAI-API-KEY` values to use for your new Azure OpenAI instance, skip this section.
+{: .note}
+> If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), or if you already have valid `AZURE-OPENAI-ENDPOINT` and `AZURE-OPENAI-API-KEY` values for an existing Azure OpenAI instance, you can skip this section.
 
 The following step-by-step guidance will show you how to create an Azure OpenAI account using the Azure CLI. If you’d like to learn more about creating these accounts, see the following documentation: [Create and deploy an Azure OpenAI Service resource](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource)
 

docs/04_lab_monitor/0402.md

@@ -22,6 +22,9 @@ To learn more about how Log Analytics works with Azure Container Apps, review:
 
 ## Step-by-step guidance
 
+{: .note}
+> If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), skip to step 2.
+
 1.  In your command-line environment, create a new Log Analytics workspace:
 
     ```bash

docs/04_lab_monitor/0403.md

@@ -26,6 +26,9 @@ For additional information on how this works, review:
 
 ## Step-by-step guidance
 
+{: .note}
+> If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), skip to step 2.
+
 1.  Your first step is to create an Application Insights resource. Execute this statement in your command-line environment:
 
     ```bash

docs/04_lab_monitor/0405.md

@@ -18,6 +18,9 @@ If you’d like to learn more about how Azure Managed Grafana helps visualize ex
 
 ## Step-by-step guidance
 
+{: .note}
+> If you've already successfully run the `create-azure-resources.sh` script discussed in the [installation instructions]({% link install.md %}#preparing-your-subscription), skip to step 2.
+
 1.  Provision Azure Managed Grafana. In your command-line environment, create an Azure Managed Grafana instance:
 
     Azure Managed Grafana is not supported in all regions. You can refer to the [Azure OpenAI global standard model availability](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#models-by-deployment-type) documentation for more details if you'd like.

install.md

@@ -176,12 +176,14 @@ After all these tools are installed, you can get started:
 
 ## Preparing your subscription
 
-With your development environment set up, you're now going to run a couple scripts to perform some setup tasks on you lab subscription and then automate the deployment of some required Azure resources that you'll use during the labs. 
+With your development environment set up, you're now going to use some scripts to perform some subscription configuration and also deploy some Azure resources that you'll use during the labs. 
 
 
 {: .note }
 We'll be using Bash commands to complete this lab. You can use any compatible command-line environment, such as the Windows Subsystem for Linux, Git Bash, or the Visual Studio Code Bash terminal. To avoid potential errors, **do not** attempt to run these commands in a PowerShell session.
 
+### Sign into Azure
+
 Before you run the scripts, you'll need to sign in to Azure and configure it to access your lab subscription.
 
 1.  In your lab environment, open a command-line environment and sign in to your Azure subscription with the following command:
@@ -207,7 +209,9 @@ Before you run the scripts, you'll need to sign in to Azure and configure it to
     az account set --subscription <subscription-id>
     ```
 
-Once you're signed in you can start running the setup scripts. The first script, `prepare.sh`, will register the required resources providers, and add any necessary extensions to Azure CLI.
+### Run the subscription preparation script
+
+Now you'll run the script `prepare.sh` to register the required resources providers on your lab subscription, and also add any necessary extensions to the Azure CLI.
 
 1.  In your command line windows, go to the root of the `java-on-aca` folder and run the script `./tools/prepare.sh`.
 
@@ -217,10 +221,14 @@ Once you're signed in you can start running the setup scripts. The first script,
 
     This process should take less than 10 minutes to complete. 
 
-Once the `prepare.sh` script finishes, you can proceed with creating the base Azure resource dependencies you'll use as you work through the labs. You'll do this using the script `create-azure-resource.sh`.
+1. Once the `prepare.sh` script finishes, close your current terminal window and start a new terminal session to access your fully prepared lab environment.
+
+### Run the resource creation script
+
+You'll now need to run the script `create-azure-resource.sh`, which will create several of the Azure resource dependencies that you'll use in the labs.
 
 1.  Before running the script, you'll need to edit the file `./tools/azure-resource.profile` in a code editor and update the following values:
-    
+
     - `UNIQUEID` - Create a unique ID string and paste that in the code editor. You can use the following command generate an acceptable value: `openssl rand -hex 3`
     - `SUBSCRIPTION` - Enter the ID of the subscription you're going to work in. To quickly find this id, use the following command: `az account show --query id`
     - `REGION` -  Enter the default Azure region you want to work in. For example `westus` or `southindia`.
@@ -257,4 +265,4 @@ Once the `prepare.sh` script finishes, you can proceed with creating the base Az
 >
 > You can also manually load the saved variables with the command `loadenv`. 
 > 
-> You can use these commands at any time, so feel free to run `saveenv` after creating or updating environment variables when working through the labs, or `loadenv` to reload your saved variables as needed. 
+> You can use these commands at any time, so feel free to run `saveenv` after creating or updating environment variables when working through the labs, or `loadenv` to reload your saved variables as needed. 

tools/create-azure-resource.sh

@@ -136,3 +136,7 @@ else
         --parameters grafanaName=$GRAFANA_NAME location=$GRAFANA_LOCATION \
         --output table
 fi
+
+# Save environment variables
+
+saveenv