Apply suggestions from code review

Co-authored-by: Karl Erickson <[email protected]>

Author: JoshTheTechWriter

articles/container-apps/java-petclinic-ai-overview.md

@@ -1,6 +1,6 @@
 ---
 title: Introduction to the Java PetClinic AI Sample in Azure Container Apps
-description: Explain the architecture of AI applications deployed to Azure Container Apps.
+description: Explains the architecture of AI applications deployed to Azure Container Apps.
 author: KarlErickson
 ms.author: sonwan
 ms.service: azure-container-apps
@@ -37,7 +37,7 @@ This gateway performs the following functions:
 
 The gateway operates within a dedicated virtual network, ensuring secure and isolated communication between the application and external systems.
 
-The following are the key components and services featured in the application:
+The following table describes the key components and services featured in the application:
 
 | Service or feature                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                          |
 |-----------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -48,12 +48,12 @@ The following are the key components and services featured in the application:
 | [Managed Identities](/entra/identity/managed-identities-azure-resources/overview) | Provides Azure services with automatically managed identities in Azure AD. Eliminates the need for credential management by allowing secure service-to-service authentication without storing credentials in code.                                                                                                                                                                                                                   |
 | [Spring AI](https://spring.io/projects/spring-ai)                                 | Spring framework for AI engineering that applies AI design principles to the Spring ecosystem. Alternatively, [Langchain4j](https://docs.langchain4j.dev/intro) is another AI framework with its own PetClinic sample in [spring-petclinic-langchain4j](https://github.com/Azure-Samples/spring-petclinic-langchain4j). For more information, see [Chat Client API](https://docs.spring.io/spring-ai/reference/api/chatclient.html).|
 
-For more information on infrastructure as code elements of the application, see the [bicep scripts](https://github.com/Azure-Samples/spring-petclinic-ai/blob/main/infra/bicep/main.bicep) in the [Bring your first AI app in Azure Container Apps](https://github.com/Azure-Samples/spring-petclinic-ai/) repository
+For more information on the infrastructure as code elements of the application, see the [bicep scripts](https://github.com/Azure-Samples/spring-petclinic-ai/blob/main/infra/bicep/main.bicep) in the [Bring your first AI app in Azure Container Apps](https://github.com/Azure-Samples/spring-petclinic-ai/) repository.
 .
 
 ## Code implementation
 
-The following information is an introduction to the code for readers to understand the flow of this first AI application:
+The following sections provide an introduction to the code to help you understand the flow of this first AI application.
 
 ### Making REST calls
 
@@ -65,7 +65,7 @@ return this.chatClient.prompt().user(u -> u.text(query)).call().content();
 
 ### Chat customizations
 
-The [`ChatConfiguration`](https://github.com/Azure-Samples/spring-petclinic-ai/blob/main/src/main/java/org/springframework/samples/petclinic/genai/ChatConfiguration.java) class customizes requests sent to `chatClient`. The following are some key configuration settings of `chatClient`:
+The [`ChatConfiguration`](https://github.com/Azure-Samples/spring-petclinic-ai/blob/main/src/main/java/org/springframework/samples/petclinic/genai/ChatConfiguration.java) class customizes requests sent to `chatClient`. The following list describes some key configuration settings of `chatClient`:
 
 - Connections authentication: The client connects to Azure OpenAI. Both API key authentication and managed identity authentication are supported.
 - Configuration settings location: For `ChatModel`, deployment `gpt-4o` and temperature `0.7` are set in the configuration file.
@@ -115,4 +115,4 @@ For more information, see [Advisors API](https://docs.spring.io/spring-ai/refere
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Deploy an AI-enabled instance of Spring PetClinic on Azure Container Apps](java-petclinic-ai-overview.md).
+> [Deploy an AI-enabled instance of Spring PetClinic on Azure Container Apps](java-petclinic-ai-overview.md)

articles/container-apps/java-petclinic-ai-tutorial.md

@@ -28,13 +28,13 @@ For information on the architectural details of this application, see [Java PetC
 
 ## Prerequisites
 
-- Azure subscription: You can [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) if you don't have an existing account.
-- Security context: To perform this quickstart, you need the `Contributor` and `User Access Administrator` roles, or the `Owner` role. For more information, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml?tabs=current).
-- GitHub account: Get one for [free](https://github.com/join).
-- git: Install the latest version of [git](https://git-scm.com/downloads).
-- Microsoft Build of Open JDK: Install [Microsoft Build of Open JDK](/java/openjdk/install). Use version 17 at a minimum.
-- Azure Command-Line interface (CLI): Install [Azure CLI](/azure/developer/azure-developer-cli/install-azd) to manage your Azure resources via command line.
-- Maven: Install the latest version of [Maven](https://maven.apache.org/download.cgi).
+- An Azure subscription. If you don't have an existing account, you can [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- `Contributor` and `User Access Administrator` roles, or the `Owner` role. For more information, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml?tabs=current).
+- [A GitHub account](https://github.com/join).
+- The latest version of [git](https://git-scm.com/downloads).
+- The [Microsoft Build of Open JDK](/java/openjdk/install), version 17 or higher.
+- [Azure CLI](/azure/developer/azure-developer-cli/install-azd).
+- [Maven](https://maven.apache.org/download.cgi).
 
 ## Setup
 
@@ -52,7 +52,7 @@ For information on the architectural details of this application, see [Java PetC
     cd spring-petclinic-ai
     ```
 
-1. If you don't already have it, install the Azure CLI.
+1. If you don't already have it, install the `containerapp` extension for the Azure CLI.
 
     ```azurecli
     az extension add --name containerapp --upgrade
@@ -70,13 +70,13 @@ For information on the architectural details of this application, see [Java PetC
 
 ## Deploy
 
-1. Automatically deploy the application by with the `azd up` command.
+1. Automatically deploy the application by using the `azd up` command.
 
     ```azdeveloper
     azd up
     ```
 
-1. When you're prompted you for a name, enter **my-first-ai** for the environment name.
+1. When you're prompted, enter **my-first-ai** for the environment name.
 
     After that, enter values for `Azure Subscription` and `Azure location`, substituting your actual values for the `<..>` placeholders in the following prompts: