Apply suggestions from code review

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

Author: anthonychu

articles/container-apps/azure-pipelines.md

@@ -17,11 +17,13 @@ The pipeline is triggered by commits to a specific branch in your repository. Wh
 
 ## Container Apps Azure Pipelines task
 
-To build and deploy your container app, add the [`AzureContainerAppsRC`](https://marketplace.visualstudio.com/items?itemName=microsoft-oryx.AzureContainerAppsRC) (preview) Azure Pipelines task to your pipeline. The task supports the following scenarios:
+To build and deploy your container app, add the [`AzureContainerAppsRC`](https://marketplace.visualstudio.com/items?itemName=microsoft-oryx.AzureContainerAppsRC) (preview) Azure Pipelines task to your pipeline.
 
-* Build from a Dockerfile and deploy to Container Apps.
-* Build from source code without a Dockerfile and deploy to Container Apps. Supported languages include .NET, Node.js, PHP, Python, and Ruby.
-* Deploy an existing container image to Container Apps.
+The task supports the following scenarios:
+
+* Build from a Dockerfile and deploy to Container Apps
+* Build from source code without a Dockerfile and deploy to Container Apps. Supported languages include .NET, Node.js, PHP, Python, and Ruby
+* Deploy an existing container image to Container Apps
 
 ### Usage examples
 
@@ -68,11 +70,11 @@ The Azure Container Apps task needs to authenticate with your Azure Container Re
 
 To push images, the task automatically authenticates with the container registry specified in `acrName` using the service connection provided in `azureSubscription`.
 
-To pull images, Azure Container Apps uses either managed identity (recommended) or admin credentials to authenticate with the Azure Container Registry. To use managed identity, the container app the task is deploying to must be [configured to use managed identity](managed-identity-image-pull.md). To authenticate with the registry's admin credentials, set the task's `acrUsername` and `acrPassword` inputs.
+To pull images, Azure Container Apps uses either managed identity (recommended) or admin credentials to authenticate with the Azure Container Registry. To use managed identity, the target container app for the task must be [configured to use managed identity](managed-identity-image-pull.md). To authenticate with the registry's admin credentials, set the task's `acrUsername` and `acrPassword` inputs.
 
 ## Configuration
 
-You take the following steps to configure an Azure DevOps pipeline to deploy to Azure Container Apps.
+Take the following steps to configure an Azure DevOps pipeline to deploy to Azure Container Apps.
 
 > [!div class="checklist"]
 > * Create an Azure DevOps repository for your app
@@ -120,15 +122,15 @@ Before creating a pipeline, the source code for your app must be in a repository
 
 ### Create a container app and configure managed identity
 
-Create your container app using the `az containerapp up` command in the following steps. This command will create Azure resources, build the container image, store the image in a registry, and deploy to a container app.
+Create your container app using the `az containerapp up` command with the following steps. This command creates Azure resources, builds the container image, stores the image in a registry, and deploys to a container app.
 
 After your app is created, you can add a managed identity to your app and assign the identity the `AcrPull` role to allow the identity to pull images from the registry. 
 
 [!INCLUDE [container-apps-github-devops-setup.md](../../includes/container-apps-github-devops-setup.md)]
 
 ### Install the Azure Container Apps task
 
-The Azure Container Apps Azure Pipelines task is currently in preview. Before you use it, you must install it from the Azure DevOps Marketplace.
+The Azure Container Apps Azure Pipelines task is currently in preview. Before you use the task, you must install it from the Azure DevOps Marketplace.
 
 1. Open the [Azure Container Apps task](https://marketplace.visualstudio.com/items?itemName=microsoft-oryx.AzureContainerAppsRC) in the Azure DevOps Marketplace.
 
@@ -197,6 +199,6 @@ To learn more about service connections, see [Connect to Microsoft Azure](/azure
 
 1. Select **Save and run**.
 
-An Azure Pipelines run should start to build and deploy your container app. To check its progress, navigate to *Pipelines* and select the run. During the first pipeline run, you may be prompted to authorize the pipeline to use your service connection.
+An Azure Pipelines run starts to build and deploy your container app. To check its progress, navigate to *Pipelines* and select the run. During the first pipeline run, you may be prompted to authorize the pipeline to use your service connection.
 
 To deploy a new revision of your app, push a new commit to the *main* branch.

articles/container-apps/github-actions.md

@@ -15,17 +15,19 @@ Azure Container Apps allows you to use GitHub Actions to publish [revisions](rev
 
 :::image type="content" source="media/github-actions/azure-container-apps-github-actions.png" alt-text="Changes to a GitHub repo trigger an action to create a new revision.":::
 
-The GitHub Actions workflow is triggered by commits to a specific branch in your repository. When creating the workflow, you decide which branch triggers it.
+The GitHub Actions workflow is triggered by commits to a specific branch in your repository. When creating the workflow, you decide which branch triggers the workflow.
 
-This article shows you how to create your own workflow that you can fully customize. To generate a starter GitHub Actions workflow with Azure CLI, see [Generate GitHub Actions workflow with Azure CLI](github-actions-cli.md).
+This article shows you how to create a fully customizable workflow. To generate a starter GitHub Actions workflow with Azure CLI, see [Generate GitHub Actions workflow with Azure CLI](github-actions-cli.md).
 
 ## Azure Container Apps GitHub action
 
-To build and deploy your container app, you add the [`azure/container-apps-deploy-action`](https://github.com/marketplace/actions/azure-container-apps-build-and-deploy) action to your GitHub Actions workflow. The action supports the following scenarios:
+To build and deploy your container app, you add the [`azure/container-apps-deploy-action`](https://github.com/marketplace/actions/azure-container-apps-build-and-deploy) action to your GitHub Actions workflow.
 
-* Build from a Dockerfile and deploy to Container Apps.
-* Build from source code without a Dockerfile and deploy to Container Apps. Supported languages include .NET, Node.js, PHP, Python, and Ruby.
-* Deploy an existing container image to Container Apps.
+The action supports the following scenarios:
+
+* Build from a Dockerfile and deploy to Container Apps
+* Build from source code without a Dockerfile and deploy to Container Apps. Supported languages include .NET, Node.js, PHP, Python, and Ruby
+* Deploy an existing container image to Container Apps
 
 ### Usage examples