multiple improvements on the docs (#166)

## Purpose

- add operations to save/load environment variables
- hide option 2 for lab 5
- update setup-azd to v2
- others

## 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)
[x] Documentation content changes
[ ] Other... Please describe:
```

Author: sonwan2020

.devcontainer/funcs.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+DEV_ENV_FILE="$HOME/.dev-environment"
+
+function saveenv() {
+    declare -p | grep "declare \(--\|-x\)" | grep -v "^declare \(--\|-x\) \(PS[0-9]\|BASH_.*\|PATH\|PWD\|LS_COLORS\)=" > "$DEV_ENV_FILE"
+}
+
+function clearenv() {
+    rm -f "$DEV_ENV_FILE"
+}
+

.devcontainer/postCreateCommand.sh

@@ -1,23 +1,24 @@
 #!/usr/bin/env bash
 
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
+source "$DIR/funcs.sh"
+
 azd config set alpha.deployment.stacks on
 
-DEV_ENV_FILE="\$HOME/.dev-environment"
+grep saveenv "$HOME/.bashrc" > /dev/null 2>&1
+if [[ $? -ne 0 ]]; then
 
-cat <<EOT >> "$HOME/.bashrc"
+    cat <<EOT >> "$HOME/.bashrc"
+
+DEV_ENV_FILE="\$HOME/.dev-environment"
 
 # auto load
-if [[ -f "$DEV_ENV_FILE" ]]; then
-    source "$DEV_ENV_FILE"
+if [[ -f "\$DEV_ENV_FILE" ]]; then
+    source "\$DEV_ENV_FILE"
 fi
 
-saveenv() {
-    # Check if var_save is set
-    declare -p | grep -v "declare -[a-z]*r" > "$DEV_ENV_FILE"
-}
+EOT
 
-clearenv() {
-    echo "" > "$DEV_ENV_FILE"
-}
+    declare -f saveenv clearenv >> "$HOME/.bashrc"
 
-EOT
+fi

.devcontainer/saveenv.sh

@@ -0,0 +1,4 @@
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
+
+source "$DIR/funcs.sh"
+saveenv

.github/workflows/azure-dev.yml

@@ -23,7 +23,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install azd
-        uses: Azure/setup-azd@v1.0.0
+        uses: Azure/setup-azd@v2
 
       - name: Install Az extensions
         run: |

docs/02_lab_launch/0209.md

@@ -12,3 +12,9 @@ In this lab, you deployed the Spring Petclinic microservices application to Azur
 The below image illustrates the end state you have build in this lab.
 
 ![lab 2 overview](../../images/acalab2.png)
+
+Tips for next labs:
+
+- This is the fundemental part for the next labs, please keep the azure resource undeleted.
+- During this lab, we defined some environment variables, some of the variables are required in the next labs. To save these variables, in the command-line window, under the directory `spring-petclinic-microservices`, run the command `source ../.devcontainer/saveenv.sh`, this command will save the environment variables to file `~/.dev-environment`.
+- The new bash environment will automatically pick up the saved environment variables. Also you can manually load the saved variables with command `source ~/.dev-environment`.

docs/05_lab_openai/0501.md

@@ -1,13 +1,15 @@
 ---
-title: 'Create Azure OpenAI resources (Optional)'
+title: '1. Create Azure OpenAI resources (Optional)'
 layout: default
 nav_order: 1
 parent: 'Lab 5: Integrate with Azure OpenAI'
 ---
 
-To add AI capablities to the application, you need create an Azure OpenAI account and deploy language models. You can use the following guidance:
+To add AI capabilities to the application, you need create an Azure OpenAI account and deploy language models. You can use the following guidance:
 - [Create and deploy an Azure OpenAI Service resource](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource)
 
+Skip this step if you already have valid `AZURE-OPENAI-ENDPOINT` and `AZURE-OPENAI-API-KEY` for your new AI service.
+
 # Step by step guidance
 
 1. Create an Azure OpenAI account. Run the following commands to create an Azure OpenAI account. Note that the name of the account must be globally unique, so adjust it accordingly in case the randomly generated name is already in use.

docs/05_lab_openai/05_openai.md

@@ -1,5 +1,5 @@
 ---
-title: 'Create AI application from scratch'
+title: '2. Create AI application from scratch'
 layout: default
 nav_order: 3
 parent: 'Lab 5: Integrate with Azure OpenAI'
@@ -13,8 +13,8 @@ We will start by creating a new Spring Boot application to connect with Azure Op
 
 Prerequisites:
 
-- Install extension `Github Copilot Chat` in VSCode.
-- Prepare the Open AI instance and install deployment 'gpt-4o'.
+- Install extension `GitHub Copilot Chat` in VSCode, try [GitHub Copilot Free](https://docs.github.com/en/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free#vs-code).
+- Prepare the Open AI instance and install deployment `gpt-4o`, see [guide]({% link docs/05_lab_openai/0501.md %}).
 - Get the `endpoint` and `api-key` from the Open AI instance.
 
 # Step by step guide
@@ -45,13 +45,13 @@ Prerequisites:
 
    Edit with VSCode will accelerate your work in the next steps.
 
-   Get the `spring-ai` version from the project.
+   Get the `spring-ai` version from the file `pom.xml` in the project.
 
    ```xml
    <spring-ai.version>1.0.0-M5</spring-ai.version>
    ```
 
-   Here the spring-ai version is `1.0.0-M5`, save it in variable:
+   Here the spring-ai version is `1.0.0-M5`, save it as variable in your command-line window:
 
    ```bash
    SPRING_AI_VERSION=1.0.0-M5
@@ -79,6 +79,7 @@ Prerequisites:
    Input the following text to the input box:
 
    ```text
+   You are a Java engineer want to write your first AI empowered service and you start the new project from some samples.
    Refer to the sample file named "AzureOpenAIChatClientIT.java", add a new ChatController with POST endpoint at '/chatclient' to the chat-service project:
    * Use ChatClient to do the chat completion with Azure OpenAI Endpoint
    * Use system prompt from static string "You are a joke bot. You are funny and witty."
@@ -105,9 +106,11 @@ Prerequisites:
      mvn clean package -DskipTests
      ```
 
-   - Fix some potential errors. You might need some minor fixes in the AI generated code. Some of the fixes including:
+     Read the code generated by GitHub Copilot. Refer to [Azure OpenAI chat properties](https://docs.spring.io/spring-ai/reference/api/chat/azure-openai-chat.html) for more info on configuration properties.
 
-      - In ChatController.java: `response.getResults().get(0).getOutput().getText()` --> `response.getResults().get(0).getOutput().getContent()`
+     - Fix some potential errors. You might need some minor fixes in the AI generated code. Some of the fixes including:
+
+       a. In ChatController.java: `response.getResults().get(0).getOutput().getText()` --> `response.getResults().get(0).getOutput().getContent()`
 
    - Run the new project locally:
 

docs/05_lab_openai/05_openai_existing.md

@@ -2,6 +2,7 @@
 title: 'Integrate AI to existing project'
 layout: default
 nav_order: 4
+nav_exclude: true
 parent: 'Lab 5: Integrate with Azure OpenAI'
 ---