incorporate review comments

dksimpson · dksimpson · commit 051ecf28be7a · 2020-03-18T16:58:46.000-07:00
diff --git a/articles/azure-functions/functions-create-first-azure-function.md b/articles/azure-functions/functions-create-first-azure-function.md
@@ -9,11 +9,7 @@ ms.custom: mvc, devcenter, cc996988-fb4f-47
 
 # Create your first function in the Azure portal
 
-Azure Functions lets you run your code in a [serverless](https://azure.microsoft.com/solutions/serverless/) environment without having to first create a virtual machine (VM) or publish a web application. In this article, you learn how to use Azure Functions to create a "hello world" HTTP-triggered function in the Azure portal.
-
-For more information about HTTP triggers, see [Azure Functions HTTP triggers and bindings overview](functions-bindings-http-webhook.md).
-
-![Create function app in the Azure portal](./media/functions-create-first-azure-function/function-app-in-portal-editor.png)
+Azure Functions lets you run your code in a serverless environment without having to first create a virtual machine (VM) or publish a web application. In this article, you learn how to use Azure Functions to create a "hello world" HTTP triggered function in the Azure portal.
 
 [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
 
@@ -31,7 +27,7 @@ You must have a function app to host the execution of your functions. A function
 
 Next, create a function in the new function app.
 
-## <a name="create-function"></a>Create an HTTP-triggered function
+## <a name="create-function"></a>Create an HTTP triggered function
 
 1. Expand your new function app, select the **+** button next to **Functions**, choose **In-portal**, and then select **Continue**.
 
@@ -41,7 +37,7 @@ Next, create a function in the new function app.
 
     ![Functions quickstart in the Azure portal.](./media/functions-create-first-azure-function/function-app-quickstart-node-webhook.png)
 
-   A function is created using a language-specific template for an HTTP-triggered function.
+   A function is created using a language-specific template for an HTTP triggered function.
 
 Now, you can run the new function by sending an HTTP request.
 
@@ -53,7 +49,7 @@ Now, you can run the new function by sending an HTTP request.
 
     ![Copy the function URL from the Azure portal](./media/functions-create-first-azure-function/function-app-develop-tab-testing.png)
 
-1. Paste the function URL into your browser's address bar. Add the query string value *&name=&lt;your_name&gt;* to the end of this URL and press Enter to run the request. 
+1. Paste the function URL into your browser's address bar. Add the query string value `&name=<your_name>` to the end of this URL and press Enter to run the request. 
 
     The following example shows the response in the browser:
 
diff --git a/articles/azure-functions/functions-create-your-first-function-visual-studio.md b/articles/azure-functions/functions-create-your-first-function-visual-studio.md
@@ -8,19 +8,17 @@ ms.custom: mvc, devcenter, vs-azure, 23113853-34f2-4f
 ---
 # Quickstart: Create your first function in Azure using Visual Studio
 
-Azure Functions lets you run your code in a [serverless](https://azure.microsoft.com/solutions/serverless/) environment without having to first create a VM or publish a web application.
+Azure Functions lets you run your code in a serverless environment without having to first create a VM or publish a web application.
 
 In this quickstart, you learn how to use Visual Studio 2019 to locally create and test a "hello world" HTTP-triggered C# function app, which you then publish to Azure. 
 
 ![Function localhost response in the browser](./media/functions-create-your-first-function-visual-studio/functions-create-your-first-function-visual-studio-browser-local-final.png)
 
-This quickstart is designed for Visual Studio 2019. If you want to create an Azure Functions project by using Visual Studio 2017, you must first install the [latest Azure Functions tools](functions-develop-vs.md#check-your-tools-version).
-
-To learn more about developing functions as .NET class libraries, see [Azure Functions C# developer reference](functions-dotnet-class-library.md).
+This quickstart is designed for Visual Studio 2019. 
 
 ## Prerequisites
 
-To complete this tutorial, first install [Visual Studio 2019](https://azure.microsoft.com/downloads/). Ensure you select the **Azure development** workload during installation.
+To complete this tutorial, first install [Visual Studio 2019](https://azure.microsoft.com/downloads/). Ensure you select the **Azure development** workload during installation. If you want to create an Azure Functions project by using Visual Studio 2017 instead, you must first install the [latest Azure Functions tools](functions-develop-vs.md#check-your-tools-version).
 
 ![Install Visual Studio with the Azure development workload](media/functions-create-your-first-function-visual-studio/functions-vs-workloads.png)
 
@@ -52,11 +50,11 @@ Before you can publish your project, you must have a function app in your Azure
 
 ## Test your function in Azure
 
-1. Copy the base URL of the function app from the **Publish** profile page. Replace the *localhost:port* portion of the URL you used to test the function locally with the new base URL. Append the query string *?name=&lt;YOUR_NAME&gt;* to this URL and run the request.
+1. Copy the base URL of the function app from the **Publish** profile page. Replace the `localhost:port` portion of the URL you used to test the function locally with the new base URL. Append the query string `?name=<YOUR_NAME>` to this URL and run the request.
 
     The URL that calls your HTTP triggered function is in the following format:
 
-    *http://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>?name=<YOUR_NAME>*
+    `http://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>?name=<YOUR_NAME>`
 
 2. Paste this new URL for the HTTP request into your browser's address bar. The following image shows the response in the browser to the remote GET request returned by the function:
 
diff --git a/includes/functions-create-function-app-portal.md b/includes/functions-create-function-app-portal.md
@@ -52,6 +52,6 @@ ms.custom: include file
 
 1. Select the Notification icon in the upper-right corner of the portal and watch for the **Deployment succeeded** message.
 
-    ![Deployment notification](./media/functions-create-function-app-portal/function-app-create-notification2.png)
-
 1. Select **Go to resource** to view your new function app. You can also select **Pin to dashboard**. Pinning makes it easier to return to this function app resource from your dashboard.
+
+    ![Deployment notification](./media/functions-create-function-app-portal/function-app-create-notification2.png)
diff --git a/includes/functions-run-function-test-local-vs.md b/includes/functions-run-function-test-local-vs.md
@@ -12,7 +12,7 @@ ms.author: glenga
 
     ![Azure local runtime](./media/functions-run-function-test-local-vs/functions-debug-local-vs.png)
 
-3. Paste the URL for the HTTP request into your browser's address bar. Append the query string *?name=&lt;YOUR_NAME&gt;* to this URL and execute the request. The following image shows the response in the browser to the local GET request returned by the function: 
+3. Paste the URL for the HTTP request into your browser's address bar. Append the query string `?name=<YOUR_NAME>` to this URL and run the request. The following image shows the response in the browser to the local GET request returned by the function: 
 
     ![Function localhost response in the browser](./media/functions-run-function-test-local-vs/functions-run-browser-local-vs.png)
 
diff --git a/includes/functions-vstools-publish.md b/includes/functions-vstools-publish.md
@@ -29,7 +29,7 @@ ms.custom: include file
 
     | Setting      | Value  | Description                                |
     | ------------ |  ------- | -------------------------------------------------- |
-    | **Name** | Globally unique name | Name that uniquely identifies your new function app. Accept this name or enter a new name. Valid characters are: *a-z*, *0-9*, and *-*. |
+    | **Name** | Globally unique name | Name that uniquely identifies your new function app. Accept this name or enter a new name. Valid characters are: `a-z`, `0-9`, and `-`. |
     | **Subscription** | Your subscription | The Azure subscription to use. Accept this subscription or select a new one from the drop-down list. |
     | **[Resource Group](../articles/azure-resource-manager/management/overview.md)** | Name of your resource group |  The resource group in which to create your function app. Select an existing resource group from the drop-down list or choose **New** to create a new resource group.|
     | **[Hosting Plan](../articles/azure-functions/functions-scale.md)** | Name of your hosting plan | Select **New** to configure a serverless plan. Make sure to choose the **Consumption** under **Size**. When you publish your project to a function app that runs in a [Consumption plan](../articles/azure-functions/functions-scale.md#consumption-plan), you pay only for executions of your functions app. Other hosting plans incur higher costs. If you run in a plan other than **Consumption**, you must manage the [scaling of your function app](../articles/azure-functions/functions-scale.md). Choose a **Location** in a [region](https://azure.microsoft.com/regions/) near you or other services your functions access.  |
diff --git a/includes/media/functions-create-function-app-portal/function-app-create-notification2.png b/includes/media/functions-create-function-app-portal/function-app-create-notification2.png
