Apply feedback from review with Mukta

Author: maud-lv

articles/azure-app-configuration/TOC.yml

@@ -21,14 +21,14 @@
           href: quickstart-dotnet-app.md
         - name: Azure Functions in .NET Core
           href: quickstart-azure-functions-csharp.md
-        - name: Container Apps
-          href: quickstart-container-apps.md
         - name: Java Spring
           href: quickstart-java-spring-app.md
-        - name: JavaScript/Node.js
-          href: quickstart-javascript.md
         - name: Python
           href: quickstart-python-provider.md
+        - name: JavaScript/Node.js
+          href: quickstart-javascript.md
+        - name: Azure Container Apps
+          href: quickstart-container-apps.md
     - name: Feature management
       items:
         - name: ASP.NET Core

articles/azure-app-configuration/index.yml

@@ -80,7 +80,7 @@ landingContent:
           url: quickstart-python.md
         - text: Azure Resource Manager template
           url: quickstart-resource-manager.md       
-        - text: Container Apps
+        - text: Azure Container Apps
           url: quickstart-container-apps.md
       - linkListType: tutorial
         links:  

articles/azure-app-configuration/media/connect-container-app/container-registry-repository.png

@@ -12,44 +12,31 @@ ms.author: malev
 
 # Quickstart: Use Azure App Configuration in Azure Container Apps
 
-In this quickstart, you will use Azure App Configuration in an ASP.NET Core app running in Azure Container Apps. This way, you can centralize the storage and management of your Container Apps configuration. This quickstart leverages the ASP.NET Core app created in [Quickstart: Create an ASP.NET Core app with App Configuration](./quickstart-aspnet-core-app.md). You will containerize the app and deploy it to Azure Container Apps. Complete the quickstart before you continue.
+In this quickstart, you will use Azure App Configuration in an app running in Azure Container Apps. This way, you can centralize the storage and management of the configuration of your apps in Container Apps. This quickstart leverages the ASP.NET Core app created in [Quickstart: Create an ASP.NET Core app with App Configuration](./quickstart-aspnet-core-app.md). You will containerize the app and deploy it to Azure Container Apps. Complete the quickstart before you continue.
 
 > [!TIP]
 > While following this quickstart, preferably register all new resources within a single resource group, so that you can regroup them all in a single place and delete them faster later on if you don't need them anymore.
 
 ## Prerequisites
 
-- The App Configuration store and the ASP.NET Core App that you created in the [Quickstart: Create an ASP.NET Core app with App Configuration](./quickstart-aspnet-core-app.md).
+- An application using an App Configuration store. If you don't have one, create an instance using the [Quickstart: Create an ASP.NET Core app with App Configuration](./quickstart-aspnet-core-app.md).
 - [Docker Desktop](https://www.docker.com/products/docker-desktop)
 - The [Azure CLI](/cli/azure/install-azure-cli)
-
-## Create an Azure Container Apps instance
-
-Start by creating a basic [Azure Container Apps](../container-apps/overview.md) instance and a Container Apps environment, where you'll later host your app.
-
-This Azure service is designed to run containerized applications.
-
-#### [Portal](#tab/azure-portal)
-
-To create the container app and container apps environment using the Azure portal, follow the [Azure Container Apps quickstart](/azure/container-apps/quickstart-portal).
-
-#### [Azure CLI](#tab/azure-cli)
-
-To create the container app and container apps environment using the Azure CLI, follow the [Azure Container Apps quickstart](/azure/container-apps/get-started). The created container app contains a default image.
+- An Azure Container Apps instance. If you don't have one, create an instance using the [Azure portal](/azure/container-apps/quickstart-portal) or [the CLI](/azure/container-apps/get-started).
 
 ---
 
-## Connect Azure Container Apps to Azure App Configuration
+## Connect the container app to Azure App Configuration
 
-In the next step, you'll add the connection string of your App Configuration store to the secret of your Container App and add an environment variable to your container to reference the secret. You use the [Service Connector](../service-connector/overview.md) to do this in a few steps without managing the connection information yourself.
+The first step of this guide is to connect your container app to your configuration store. To do this, add the connection string of your App Configuration store to the secret of your Container App, and add an environment variable to your container to reference the secret. Use [Service Connector](../service-connector/overview.md) to do this in a few steps without managing the connection information yourself.
 
 In the Azure portal, connect the container app to Azure App Configuration following the [Service Connector quickstart for Azure Container Apps](../service-connector/quickstart-portal-container-apps.md). While following the steps of the quickstart:
 
 - In the **Basics** tab:
-
   - select **App Configuration** for **Service type**
-  - pick the App Configuration store created in the quickstart for "**App Configuration**"
-  - select **.NET** for **Client Type**.
+  - pick your App Configuration store for "**App Configuration**"
+
+    :::image type="content" border="true" source="media\connect-container-app\use-service-connector.png" alt-text="Screenshot the Azure platform showing a form in the Service Connector menu in a Container App.":::
 
 - In the **Authentication** tab:
   - pick **Connection string** authentication type and **Read-Only** for "**Permissions for the connection string**
@@ -58,7 +45,7 @@ In the Azure portal, connect the container app to Azure App Configuration follow
 
 Once done, an environment variable named **ConnectionStrings__AppConfig** will be added to the container of your Container App. Its value is a reference of the Container App secret, the connection string of your App Configuration store. The _ConnectionStrings__AppConfig_ is the environment variable your app built from the quickstart will look for.
 
-## Build the container
+## Build a container
 
 1. Run the [dotnet publish](/dotnet/core/tools/dotnet-publish) command to build the app in release mode and create the assets in the *published* folder.
 
@@ -90,7 +77,7 @@ Create an Azure Container Registry (ACR). ACR enables you to build, store, and m
 1. To create the container registry, follow the [Azure Container Registry quickstart](/azure/container-registry/container-registry-get-started-portal).
 1. Once the deployment is complete, open your ACR instance and from the left menu, select **Settings > Access keys**.
 1. Take note of the **Login server** value listed on this page. You'll use this information in a later step.
-1. Switch **Admin user** to *Enabled*. This option lets you connect the ACR to Azure Container Apps using admin user credentials.
+1. Switch **Admin user** to *Enabled*. This option lets you connect the ACR to Azure Container Apps using admin user credentials. If you leave it disabled, you can still connect the container registry and the container app using a managed identity.
 
 #### [Azure CLI](#tab/azure-cli)
 
@@ -112,14 +99,14 @@ Push the Docker image to the ACR created earlier.
 
     The command returns `Login Succeeded` once login is successful.
 
-1. Use [docker tag](https://docs.docker.com/engine/reference/commandline/tag/) to tag the image with the ACR name
+1. Use [docker tag](https://docs.docker.com/engine/reference/commandline/tag/) to tag the image appropriate details.
 
     ```docker
     docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
     ```
 
     > [!TIP]
-    > To review the list of your existing docker images and tags, run `docker image ls`.
+    > To review the list of your existing docker images and tags, run `docker image ls`. In this scenario, you should see at least two images: `aspnetapp` and `myregistry.azurecr.io/aspnetapp`.
 
 1. Use [docker push](https://docs.docker.com/engine/reference/commandline/push/) to push the image to the container registry. This example creates the *aspnetapp* repository in ACR containing the `aspnetapp` image. In the example below, replace the placeholders `<login-server`, `<image-name>` and `<tag>` by the ACR's log-in server value, the image name and the image tag.
 
@@ -135,6 +122,10 @@ Push the Docker image to the ACR created earlier.
     docker push myregistry.azurecr.io/aspnetapp:v1
     ```
 
+1. Open your Azure Container Registry in the Azure portal and confirm that under **Repositories**, you can see your new repository.
+
+    :::image type="content" border="true" source="media\connect-container-app\container-registry-repository.png" alt-text="Screenshot of the Azure platform showing a repository in Azure Container Registries.":::
+
 ## Add your container image to Azure Container Apps
 
 Update the existing container app by importing the docker image you created and pushed to ACR earlier.
@@ -147,13 +138,13 @@ Update the existing container app by importing the docker image you created and
 1. Under **Container image**, click on the name of the existing container image.
 1. Update the following settings:
 
-    | Setting               | Suggested value                                                                                         | Description                                                                                                                                                                       |
-    |-----------------------|---------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-    | Image source          | *Azure Container Registry*                                                                              | Select Azure Container Registry as your image source.                                                                                                                             |
-    | Authentication        | *Admin Credentials*                                                                                     | Connect with the admin user credentials enabled in the Azure Container Registry.                                                                                                                             |
-    | Registry              | *myregistry.azurecr.io*                                                                                 | Select the Azure Container Registry you created earlier.                                                                                                                          |
-    | Image                 | *aspnetapp*                                                                                             | Select the docker image you created and pushed to ACR earlier.                                                                                                                    |
-    | Image tag             | *v1*                                                                                                    | Select your image tag from the list.                                                                                                                                              |
+    | Setting        | Suggested value            | Description                                                                      |
+    |----------------|----------------------------|----------------------------------------------------------------------------------|
+    | Image source   | *Azure Container Registry* | Select Azure Container Registry as your image source.                            |
+    | Authentication | *Admin Credentials*        | Use the admin user credential option that was enabled earlier in the container registry. You can also [use a managed identity](../container-apps/managed-identity-image-pull.md?tabs=azure-cli&pivots=azure-portal), in which case you will need to manually enter the image and tag in the form. |
+    | Registry       | *myregistry.azurecr.io*    | Select the Azure Container Registry you created earlier.                         |
+    | Image          | *aspnetapp*                | Select the docker image you created and pushed to ACR earlier.                   |
+    | Image tag      | *v1*                       | Select your image tag from the list.                                             |
 
 1. Select **Save** and then **Create** to deploy the update to Azure Container App.