Merge pull request #285858 from v-albemi/quickstart-python

Freshness - Azure App Service

Author: Jill Grant

articles/app-service/includes/deploy-intelligent-apps/deploy-intelligent-apps-linux-python-pivot.md

@@ -13,11 +13,11 @@ You can use Azure App Service to work with popular AI frameworks like LangChain
 #### Prerequisites
 
 - An [Azure OpenAI resource](/azure/ai-services/openai/quickstart?pivots=programming-language-csharp&tabs=command-line%2Cpython#set-up) or an [OpenAI account](https://platform.openai.com/overview).
-- A Flask web application. Create the sample app using our [quickstart](../../quickstart-python.md?tabs=flask%2Cwindows%2Cazure-cli%2Cvscode-deploy%2Cdeploy-instructions-azportal%2Cterminal-bash%2Cdeploy-instructions-zip-azcli#1---sample-application).
+- A Flask web application. Create the sample app using our [quickstart](../../quickstart-python.md?tabs=flask%2Cwindows%2Cazure-cli%2Cvscode-deploy%2Cdeploy-instructions-azportal%2Cterminal-bash%2Cdeploy-instructions-zip-azcli#sample-application).
 
 ### Setup flask web app
 
-For this Flask web application, we are building off the [quickstart](../../quickstart-python.md?tabs=flask%2Cwindows%2Cazure-cli%2Cvscode-deploy%2Cdeploy-instructions-azportal%2Cterminal-bash%2Cdeploy-instructions-zip-azcli#1---sample-application) app and updating the *app.py* file to send and receive requests to an Azure OpenAI OR OpenAI service using LangChain.
+For this Flask web application, we are building off the [quickstart](../../quickstart-python.md?tabs=flask%2Cwindows%2Cazure-cli%2Cvscode-deploy%2Cdeploy-instructions-azportal%2Cterminal-bash%2Cdeploy-instructions-zip-azcli#sample-application) app and updating the *app.py* file to send and receive requests to an Azure OpenAI OR OpenAI service using LangChain.
 
 First, copy, and replace the *index.html* file with the following code:
 
@@ -282,7 +282,7 @@ client = AzureOpenAI(
 )
 ```
 
-Once the credentials are added to the application, you�ll then need to enable managed identity in your application and grant access to the resource.
+Once the credentials are added to the application, you'll then need to enable managed identity in your application and grant access to the resource.
 
 1. In your web app resource, navigate to the **Identity** blade and turn on **System assigned** and click **Save**
 2. Once System assigned identity is turned on, it registers the web app with Microsoft Entra ID and the web app can be granted permissions to access protected resources.  

articles/app-service/includes/quickstart-python/create-app-cli.md

@@ -8,7 +8,7 @@ Azure CLI commands can be run on a computer with the [Azure CLI installed](/cli/
 
 Azure CLI has a command `az webapp up` that will create the necessary resources and deploy your application in a single step.
 
-If necessary, login to Azure using [az login](/cli/azure/authenticate-azure-cli).
+If necessary, log in to Azure using [az login](/cli/azure/authenticate-azure-cli).
 
 ```azurecli
 az login
@@ -24,7 +24,7 @@ az webapp up --runtime PYTHON:3.9 --sku B1 --logs
 * The `--sku` parameter defines the size (CPU, memory) and cost of the app service plan. This example uses the B1 (Basic) service plan, which will incur a small cost in your Azure subscription. For a full list of App Service plans, view the [App Service pricing](https://azure.microsoft.com/pricing/details/app-service/linux/) page.
 * The `--logs` flag configures default logging required to enable viewing the log stream immediately after launching the webapp.
 * You can optionally specify a name with the argument `--name <app-name>`. If you don't provide one, then a name will be automatically generated.
-* You can optionally include the argument `--location <location-name>` where `<location_name>` is an available Azure region. You can retrieve a list of allowable regions for your Azure account by running the [`az account list-locations`](/cli/azure/appservice#az-appservice-list-locations) command.
+* You can optionally include the argument `--location <location-name>` where `<location_name>` is an available Azure region. You can retrieve a list of allowable regions for your Azure account by running the [`az appservice list-locations`](/cli/azure/appservice#az-appservice-list-locations) command.
 
 The command may take a few minutes to complete. While the command is running, it provides messages about creating the resource group, the App Service plan, and the app resource, configuring logging, and doing ZIP deployment. It then gives the message, "You can launch the app at http://&lt;app-name&gt;.azurewebsites.net", which is the app's URL on Azure.
 

articles/app-service/includes/quickstart-python/create-app-service-azure-portal-1.md

@@ -7,4 +7,4 @@ ms.date: 01/29/2022
 In the Azure portal:
 
    1. Enter *app services* in the search bar at the top of the Azure portal.
-   1. Select the item labeled **App Services** under the under **Services** heading on the menu that appears below the search bar.
+   1. Select the item labeled **App Services** under the **Services** heading on the menu that appears below the search bar.

articles/app-service/includes/quickstart-python/create-app-service-azure-portal-4.md

@@ -4,8 +4,8 @@ ms.author: daberry
 ms.topic: include
 ms.date: 07/26/2023
 ---
-The App Service plan controls how many resources (CPU/memory) are available to your app and the cost of those resources.<br>
+The App Service plan controls the amount of resources (CPU/memory) that are available to your app and the cost of those resources.<br>
 <br>
-For this example, under **Dev/Test**, select the **Basic B1** plan.  The Basic B1 plan will incur a small charge against your Azure account but is recommended for better performance over the Free F1 plan.<br>
+For this example, under **Dev/Test**, select the **Basic B1** plan. The Basic B1 plan will incur a small charge against your Azure account but is recommended for better performance over the Free F1 plan.<br>
 <br>
 When finished, select **Select** to apply your changes.

articles/app-service/includes/quickstart-python/deploy-local-git-azure-portal-3.md

@@ -4,6 +4,6 @@ ms.author: daberry
 ms.topic: include
 ms.date: 01/29/2022
 ---
-After saving, the page will refresh and display the address for the remote Git repository.<br>
+After you save the page, it will refresh and display the address for the remote Git repository.<br>
 <br>
 Copy the value of the **Git Clone Uri** as this value will be used to set up a Git remote in a later step.

articles/app-service/includes/quickstart-python/deploy-local-git-azure-portal-4.md

@@ -4,7 +4,7 @@ ms.author: daberry
 ms.topic: include
 ms.date: 07/26/2023
 ---
-On the *Deployment Center* page
+On the *Deployment Center* page:
 
 1. Navigate to the **Local Git/FTPS credentials** tab.
 1. Locate the local git username and password under the **Application scope** credentials.

articles/app-service/includes/quickstart-python/deploy-local-git.md

@@ -4,7 +4,7 @@ ms.author: cephalin
 ms.topic: include
 ms.date: 01/29/2022
 ---
-You can deploy your application code from a local Git repository to Azure by configuring a [Git remote](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes) in your local repo pointing at Azure to push code to. The URL of the remote repository and Git credentials needed for configuration can be retrieved using either the Azure portal or the Azure CLI.
+You can deploy your application code from a local Git repository to Azure by configuring a [Git remote](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes) in your local repo that points at the repo you want to push code to. The URL of the remote repository and Git credentials needed for configuration can be retrieved using either the Azure portal or the Azure CLI.
 
 ### [Azure portal](#tab/deploy-instructions-azportal)
 
@@ -21,7 +21,7 @@ Next, in the root directory of your application, configure a [Git remote](https:
 git remote add azure <git-deployment-url>
 ```
 
-You can now push code from your local Git repository to Azure using the Git remote you just configured. The default deployment branch for App Service is `master`, but many Git repositories are moving away from `master` to `main`. You can either specify the mapping from local branch name to remote branch name in the push (as shown below), or you can configure your [`DEPLOYMENT_BRANCH` app setting](../../deploy-local-git.md?tabs=cli#change-deployment-branch).
+You can now push code from your local Git repository to Azure using the Git remote you just configured. The default deployment branch for App Service is `master`, but many Git repositories are moving away from `master` and using `main`. You can either specify the mapping from local branch name to remote branch name in the push (as shown below), or you can configure your [`DEPLOYMENT_BRANCH` app setting](../../deploy-local-git.md?tabs=cli#change-deployment-branch).
 
 ```bash
 git push azure main:master
@@ -31,11 +31,11 @@ The first time you push code to Azure, Git will prompt you for the Azure deploym
 
 ### [Azure CLI](#tab/deploy-instructions-azcli)
 
-First, configure the deployment source for your web app to be local Git using the `az webapp deployment source` command.  This command will output the URL of the remote Git repository that you will be pushing code to.  Make a copy of this value as you will need it in a later step.
+First, configure the deployment source for your web app to be local Git using the `az webapp deployment source` command.  This command will output the URL of the remote Git repository that you'll be pushing code to.  Make a copy of this value as you'll need it in a later step.
 
 [!INCLUDE [CLI deploy configure](./deploy-local-instructions-cli-1.md)]
 
-Retrieve the deployment credentials for your application.  These will be needed for Git to authenticate to Azure when you push code to Azure in a later step.
+Retrieve the deployment credentials for your application. Git will need these to authenticate to Azure when you push code to Azure in a later step.
 
 [!INCLUDE [CLI deploy retrieve credentials](./deploy-local-instructions-cli-2.md)]
 
@@ -45,10 +45,10 @@ Next, in the root directory of your application, configure a [Git remote](https:
 git remote add azure <git-deployment-url>
 ```
 
-You can now push code from your local Git repository to Azure using the Git remote you just configured. The default deployment branch for App Service is `master`, but many Git repositories are moving away from `master` to `main`. You can either specify the mapping from local branch name to remote branch name in the push (as shown below), or you can configure your [`DEPLOYMENT_BRANCH` app setting](../../deploy-local-git.md?tabs=cli#change-deployment-branch).
+You can now push code from your local Git repository to Azure using the Git remote you just configured. The default deployment branch for App Service is `master`, but many Git repositories are moving away from `master` and using `main`. You can either specify the mapping from local branch name to remote branch name in the push (as shown below), or you can configure your [`DEPLOYMENT_BRANCH` app setting](../../deploy-local-git.md?tabs=cli#change-deployment-branch).
 
 ```bash
 git push azure main:master
 ```
 
-The first time you push code to Azure, Git will prompt you for the Azure deployment credentials you obtained in a previous step. Git will then cache these credentials so you won't have to reenter them on subsequent deployments.
+The first time you push code to Azure, Git will prompt you for the Azure deployment credentials you obtained in a previous step. Git will then cache these credentials so you won't have to re-enter them on subsequent deployments.

articles/app-service/includes/quickstart-python/stream-logs-azure-portal-1.md

@@ -4,9 +4,9 @@ ms.author: daberry
 ms.topic: include
 ms.date: 01/29/2022
 ---
-First, you need to enable streaming logs in Azure App Service. Navigate to page for the App Service instance in the Azure portal.<br>
+First, you need to enable streaming logs in Azure App Service. Navigate to the page for the App Service instance in the Azure portal.<br>
 <br>
-1. Select the **App Service logs** under the **Monitoring** heading in the menu on the left side of the page.
+1. Select **App Service logs** under the **Monitoring** heading in the menu on the left side of the page.
 1. Change the **Application Logging** property from **Off** to **File System**.
 1. Enter a retention period of 30 days for the logs.
 1. Select **Save** to save your changes.

articles/app-service/includes/quickstart-python/stream-logs-azure-portal-2.md

@@ -4,6 +4,6 @@ ms.author: daberry
 ms.topic: include
 ms.date: 01/29/2022
 ---
-Select the **Log stream** item from the menu under the **Monitoring** section. Refresh the home page in the app or attempt other requests to generate some log messages.<br>
+Select **Log stream** from the **Monitoring** section in the navigation pane on the left. Refresh the home page in the app or attempt other requests to generate some log messages.<br>
 <br>
-You will see any log messages generated by your app and messages generated by the service in the output.
+You'll see any log messages generated by your app and messages generated by the service in the output.

articles/app-service/includes/quickstart-python/stream-logs-visual-studio-code-2.md

@@ -4,6 +4,6 @@ ms.author: daberry
 ms.topic: include
 ms.date: 01/29/2022
 ---
-The console logs appear in VS Code's Output window. Refresh the home page in the app or attempt other requests to generate some log messages.<br>
+The console logs appear in the VS Code Output window. Refresh the home page in the app or attempt other requests to generate some log messages.<br>
 <br>
-You will see any log messages generated by your app as well as other messages generated by the service in the output.
+You'll see any log messages generated by your app as well as other messages generated by the service in the output.