Apply suggestions from code review

Co-authored-by: Craig Shoemaker <[email protected]>

Author: maud-lv

articles/container-apps/TOC.yml

@@ -76,7 +76,7 @@
       href: ingress.md
     - name: Set up custom domains and certificates
       href: custom-domains-certificates.md
-    - name: Connect to a backing service
+    - name: Connect to a cloud service using Service Connector
       href: how-to-connect-backing-service.md
     - name: Connect multiple apps
       href: connect-apps.md

articles/container-apps/how-to-connect-backing-service.md

@@ -1,19 +1,19 @@
 ---
-title: How to connect a Container Apps instance to a backing service
-description: Quickstart showing how to connect a container app to a target Azure service using the Azure portal or the CLI.
+title: Connect a container app to a cloud service with Service Connector
+description: Learn to connect a container app to an Azure service using the Azure portal or the CLI.
 author: maud-lv
 ms.author: malev
-ms.service: service-connector
+ms.service: container-apps
 ms.topic: how-to
-ms.date: 05/24/2022
+ms.date: 06/16/2022
 # Customer intent: As an app developer, I want to connect a containerized app to a storage account in the Azure portal using Service Connector.
 ---
 
 # How to connect a Container Apps instance to a backing service
 
-Azure Container Apps now supports Service Connector. Service Connector is an Azure solution that helps you connect Azure compute services to backing services in just a few steps. Service Connector manages the configuration of the network settings and connection information between compute and target backing services, so you don't have to think about it. To view all supported target services, [learn more about Service Connector](../service-connector/overview.md#what-services-are-supported-in-service-connector).
+Azure Container Apps allows you to use Service Connector to connect to cloud services in just a few steps. Service Connector manages the configuration of the network settings and connection information between different services. To view all supported services, [learn more about Service Connector](../service-connector/overview.md#what-services-are-supported-in-service-connector).
 
-In the guide below, learn how to connect your container app to a target service using the Azure portal or the CLI. In this article, we're connecting Container Apps to Azure Blob Storage.
+In this article, you learn to connect a container app to Azure Blob Storage.
 
 > [!IMPORTANT]
 > This feature in Container Apps is currently in preview.
@@ -23,59 +23,57 @@ In the guide below, learn how to connect your container app to a target service
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet).
 - An application deployed to Container Apps in a [region supported by Service Connector](../service-connector/concept-region-support.md). If you don't have one yet, [create and deploy a container to Container Apps](quickstart-portal.md)
-- A resource in a target service, such as Azure Blob Storage
+- An Azure Blob Storage account
 
 ## Sign in to Azure
 
-First, sign in to the Azure portal.
+First, sign in to Azure.
 
 ### [Portal](#tab/azure-portal)
 
 Sign in to the Azure portal at [https://portal.azure.com/](https://portal.azure.com/) with your Azure account.
 
 ### [Azure CLI](#tab/azure-cli)
 
-Sign in to the Azure portal using the `az login` command in the [Azure CLI](/cli/azure/install-azure-cli).
 
 ```azurecli-interactive
 az login
-```
-
-This command will prompt your web browser to launch and load an Azure sign-in page. If the browser fails to open, use device code flow with `az login --use-device-code`. For more sign in options, go to [sign in with the Azure CLI](/cli/azure/authenticate-azure-cli).
-
 ---
 
-## Create a new service connection in Container Apps
+## Create a new service connection
 
 Use Service Connector to create a new service connection in Container Apps using the Azure portal or the CLI.
 
 ### [Portal](#tab/azure-portal)
 
-1. Select **All resources** on the left of the Azure portal. Type **Container Apps** in the filter and select the name of the container app you want to use in the list.
-1. Select **Service Connector** from the left table of contents. Then select **Create**.
+1. Navigate to the Azure portal.
+1. Select **All resources** on the left of the Azure portal.
+1. Enter **Container Apps** in the filter and select the name of the container app you want to use in the list.
+1. Select **Service Connector** from the left table of contents.
+1. Select **Create**.
 
     :::image type="content" source="media/connect-backing/connect-service-connector.png" alt-text="Screenshot of the Azure portal, selecting Service Connector within a container app" lightbox="media/connect-backing/connect-service-connector-expanded.png":::
 
 1. Select or enter the following settings.
 
-| Setting      | Suggested value  | Description                                        |
-| ------------ |  ------- | -------------------------------------------------- |
-| **Container** | Your container | Select your Container Apps. |
-| **Service type** | Blob Storage | Target service type. If you don't have a Storage Blob container, you can [create one](../storage/blobs/storage-quickstart-blobs-portal.md) or use another service type. |
-| **Subscription** | One of your subscriptions | The subscription containing your target service. The default value is the subscription for your Container App instance. |
-| **Connection name** | Generated unique name | The connection name that identifies the connection between your container app and target service  |
-| **Storage account** | Your storage account | The target storage account you want to connect to. If you choose a different service type, select the corresponding target service instance. |
-| **Client type** | The app stack in your selected container | Your application stack that works with the target service you selected. The default value is **none**, which will generate a list of configurations. If you know about the app stack or the client SDK in the container you selected, select the same app stack for the client type. |
+| Setting | Suggested value | Description |
+| --- | --- | --- |
+| **Container** | Your container name | Select your Container Apps. |
+| **Service type** | Blob Storage | This is the target service type. If you don't have a Storage Blob container, you can [create one](../storage/blobs/storage-quickstart-blobs-portal.md) or use another service type. |
+| **Subscription** | One of your subscriptions | The subscription containing your target service. The default value is the subscription for your container app. |
+| **Connection name** | Generated unique name | The connection name that identifies the connection between your container app and target service. |
+| **Storage account** | Your storage account name | The target storage account to which you want to connect. If you choose a different service type, select the corresponding target service instance. |
+| **Client type** | The app stack in your selected container | Your application stack that works with the target service you selected. The default value is **none**, which generates a list of configurations. If you know about the app stack or the client SDK in the container you selected, select the same app stack for the client type. |
 
 1. Select **Next: Authentication** to select the authentication type. Then select **Connection string** to use access key to connect your Blob Storage account.
 
 1. Select **Next: Network** to select the network configuration. Then select **Enable firewall settings** to update firewall allowlist in Blob Storage so that your container apps can reach the Blob Storage.
 
-1. Then select **Next: Review + Create**  to review the provided information. Running the final validation takes a few seconds. Then select **Create** to create the service connection. It might take one minute to complete the operation.
+1. Then select **Next: Review + Create**  to review the provided information. Running the final validation takes a few seconds. Then select **Create** to create the service connection. It might take a minute or so to complete the operation.
 
 ### [Azure CLI](#tab/azure-cli)
 
-Go through the steps below to create a service connection using an access key or a system-assigned managed identity.
+The following steps create a service connection using an access key or a system-assigned managed identity.
 
 1. Use the Azure CLI command `az containerapp connection list-support-types` to view all supported target services.