acrolinx

Signed-off-by: Hannah Hunter <[email protected]>

Author: hhunter-ms

articles/azure-functions/durable/durable-functions-mssql-container-apps-hosting.md

@@ -28,7 +28,7 @@ This article shows how to host a Durable Functions app in Azure Container Apps.
 In Visual Studio Code, [create a .NET isolated Durable Functions project](./quickstart-mssql.md) configured to use the MSSQL backend. Follow the article until the [Test locally](./quickstart-mssql.md#test-locally) section and make sure you can run the app locally before going to the next step. 
 
 ### Add Docker related files
-1. In the project root directory, add a _Dockerfile_ with the following content:
+1. In the project root directory, add a *Dockerfile* with the following content:
     ```
     FROM mcr.microsoft.com/dotnet/sdk:8.0 AS installer-env
 
@@ -46,13 +46,13 @@ In Visual Studio Code, [create a .NET isolated Durable Functions project](./quic
     COPY --from=installer-env ["/home/site/wwwroot", "/home/site/wwwroot"]
     ```
 
-1. Add a _.dockerignore_ file with the following content:
+1. Add a *.dockerignore* file with the following content:
     ```
     local.settings.json
     ```
 
 ## Build the container image 
-The Dockerfile in the project root describes the minimum required environment to run the function app in a container. The complete list of supported base images for Azure Functions is documented above as Host images in the pre-requisites section or can be found in the [Azure Functions Base by Microsoft | Docker Hub](https://hub.docker.com/_/microsoft-azure-functions-base)
+The Dockerfile in the project root describes the minimum required environment to run the function app in a container. You can find the complete list of supported base images for Azure Functions documented as Host images in the prerequisites section or can be found in the [Azure Functions Base by Microsoft | Docker Hub](https://hub.docker.com/_/microsoft-azure-functions-base)
 
 1. Start the Docker daemon. 
 
@@ -75,24 +75,24 @@ The Dockerfile in the project root describes the minimum required environment to
     docker push $dockerId/$imageName:$imageVersion
     ```
 
-Depending on network speed, pushing the image the first time might take a few minutes (pushing subsequent changes is much faster). While you're waiting, proceed to the next section to create Azure resources in another terminal.
+Depending on network speed, pushing the image the first time might take a few minutes (pushing subsequent changes is faster). While you're waiting, proceed to the next section to create Azure resources in another terminal.
 
 ## Create Azure resources
-The following instructions will guide you through creating these Azure resources:
+The following instructions guide you through creating these Azure resources:
 - Azure resource group: For convenient cleanup later, all resources are created in this group. 
 - Azure Container App environment: Environment where container app is hosted. 
 - Azure Container App: Image containing the Durable Functions app is deployed to this app. 
 - Azure Storage Account: Required by the function app to store app related data such as application code. 
 - A virtual network: Required when running container apps. 
 
-### Initial set up
-1. Login to your Azure subscription:
+### Initial setup
+1. Log in to your Azure subscription:
 ```azurecli
 az login  
 az account set -subscription | -s <subscription_name>
 ```
 
-1. Run the required commands to set up the Azure Container Apps CLI extension:
+1. Run the required commands to setup the Azure Container Apps CLI extension:
 ```azurecli
 az upgrade
 
@@ -104,7 +104,7 @@ az provider register --namespace Microsoft.OperationalInsights
 ```
 
 ### Create app related resources
-A workload profile determines the amount of compute and memory resources available to the container apps deployed in an environment. The following creates a Consumption workload profile for scale-to-zero support and pay-per-use. Learn more about [workload profiles](../functions-container-apps-hosting.md#hosting-and-workload-profiles). 
+A workload profile determines the amount of compute and memory resources available to the container apps deployed in an environment. Create a Consumption workload profile for scale-to-zero support and pay-per-use. Learn more about [workload profiles](../functions-container-apps-hosting.md#hosting-and-workload-profiles). 
 
 ```azurecli
 location=<REGION>
@@ -167,14 +167,14 @@ You need to create an Azure Storage account for storing app related data:
 az storage account create --name $storage --location $location --resource-group $resourceGroup --sku $storageSku
 ```
 
-Your Durable Functions also needs an Azure SQL Database as its storage backend. This is where state information is persisted as your orchestrations run. In the Azure portal, you can [create an Azure SQL database](/azure/azure-sql/database/single-database-create-quickstart). During creation:
-- Enable Azure services and resources to access this server (under _Networking_)
-- Set the value for _Database collation_ (under _Additional settings_) to `Latin1_General_100_BIN2_UTF8`.
+Your Durable Functions also needs an Azure SQL Database as its storage backend. This backend is where state information is persisted as your orchestrations run. In the Azure portal, you can [create an Azure SQL database](/azure/azure-sql/database/single-database-create-quickstart). During creation:
+- Enable Azure services and resources to access this server (under **Networking**)
+- Set the value for **Database collation** (under **Additional settings**) to `Latin1_General_100_BIN2_UTF8`.
 
-> [!NOTE] Enabling the **Allow Azure services and resources to access this server** setting is not a recommended security practice for production scenarios. Real applications should implement more secure approaches, such as stronger firewall restrictions or virtual network configurations.
+> [!NOTE] Enabling the **Allow Azure services and resources to access this server** setting isn't a recommended security practice for production scenarios. Real applications should implement more secure approaches, such as stronger firewall restrictions or virtual network configurations.
 
 ### Configure identity-based authentication
-Managed identities make your app more secure by eliminating secrets from your app, such as credentials in the connection strings. You can choose between [system-assigned and user-assigned managed identity](/entra/identity/managed-identities-azure-resources/overview). This article demonstrates setting up user-assigned managed identity, which is the recommended option as it is not tied to the app lifecycle.
+Managed identities make your app more secure by eliminating secrets from your app, such as credentials in the connection strings. You can choose between [system-assigned and user-assigned managed identity](/entra/identity/managed-identities-azure-resources/overview). This article demonstrates setting up user-assigned managed identity, which is the recommended option as it isn't tied to the app lifecycle.
 
 1. Create identity and assign it to the container app:
     ```azurecli
@@ -223,7 +223,7 @@ Managed identities make your app more secure by eliminating secrets from your ap
     ```
 
 > [!NOTE]
-> Authenticating to the MSSQL database using managed identity is not yet supported when hosting a Durable Functions app in Azure Container Apps. Only connection string is supported today. 
+> Authenticating to the MSSQL database using managed identity isn't yet supported when hosting a Durable Functions app in Azure Container Apps. Only connection string is supported today. 
 >
 > If you forget the password from the previous database creation step, you can reset it on the SQL server resource:
 > :::image type="content" source="/media/quickstart-mssql/mssql-azure-reset-pass-2.png" alt-text="Screenshot showing reset password button.":::
@@ -242,7 +242,7 @@ Managed identities make your app more secure by eliminating secrets from your ap
 1. Add these settings required by the app:
     - `AzureWebJobsStorage__accountName`: <STORAGE_NAME>
     - `AzureWebJobsStorage__clientId`: <IDENTITY_CLIENT_ID>
-    - `AzureWebJobsStorage__credential`: managedidentity
+    - `AzureWebJobsStorage__credential`: <managedidentity>
     - `SQLDB_Connection`: <SQLDB_CONNECTION_STRING>
     - `FUNCTIONS_WORKER_RUNTIME`: <APP_LANGUAGE>
 
@@ -266,7 +266,7 @@ Managed identities make your app more secure by eliminating secrets from your ap
 
    The response is the HTTP function's initial result. It lets you know that the Durable Functions orchestration started successfully. It doesn't yet display the end result of the orchestration. The response includes a few useful URLs.
 
-1. Copy the URL value for `statusQueryGetUri`, paste it in your browser's address bar, and execute the request. Alternatively, you can also continue to use the HTTP test tool to issue the GET request.
+1. Copy the URL value for `statusQueryGetUri`, paste it in your browser's address bar, and execute the request. Alternatively, you can also continue to use the HTTP test tool to issue the `GET` request.
 
     The request queries the orchestration instance for the status. You should see that the instance finished and that it includes the outputs or results of the Durable Functions app like in this example:
 
@@ -286,9 +286,7 @@ Managed identities make your app more secure by eliminating secrets from your ap
 
 ## Next steps
 
-- Learn more about [Azure Container Apps hosting of Azure Functions](../functions-container-apps-hosting.md). 
-- See the [MSSQL storage provider documentation](https://microsoft.github.io/durabletask-mssql/) for more information about this backend's architecture, configuration, and workload behavior. 
-- Learn about the Azure-managed storage backend [Durable Task Scheduler](./durable-task-scheduler/durable-task-scheduler.md)
-
-
-
+Learn more about:
+- [Azure Container Apps hosting of Azure Functions](../functions-container-apps-hosting.md). 
+- [MSSQL storage provider](https://microsoft.github.io/durabletask-mssql/) architecture, configuration, and workload behavior. 
+- The Azure-managed storage backend, [Durable Task Scheduler](./durable-task-scheduler/durable-task-scheduler.md).