acrolynx updates

KarlErickson · KarlErickson · commit bc3b195a83c8 · 2019-06-03T09:51:47.000-07:00
diff --git a/articles/app-service/containers/tutorial-javascript-vscode-containerize-app.md b/articles/app-service/containers/tutorial-javascript-vscode-containerize-app.md
@@ -12,35 +12,35 @@ ms.devlang: javascript
 
 Next, use the Docker extension to add the necessary files to create an image for your app, build the image, and push it to a registry.
 
-> **Tip:** If you don't already have an app for this walkthrough, follow the [Node.js tutorial](/docs/nodejs/nodejs-tutorial.md).
+> **Tip:** If you don't already have an app for this quickstart, follow the [Node.js tutorial](/docs/nodejs/nodejs-tutorial.md).
 
 ## Add Docker files
 
 Open the **Command Palette** (CTRL + SHIFT + P) and type `add docker files to workspace` to run the **Docker: Add Docker files to workspace** command. This command will create the necessary Docker files. Choose your application type - **Node.js** in this tutorial - along with the port that your application listens on.
 
 > **Tip:** Be sure that the port you select matches the port your app listens on. If you used the Express generator, set this to 3000.
 
-This will add a `Dockerfile` along with some configuration files for Docker compose and a `.dockerignore`.
+This action will add a `Dockerfile` along with some configuration files for Docker compose and a `.dockerignore`.
 
 > **Tip**: VS Code has great support for Docker files. See the [Working with Docker](/docs/azure/docker.md) topic to learn about rich language features like smart suggestions, completions, and error detection.
 
 ## Build a Docker image
 
-The files you just added, specifically, `Dockerfile`, describe the environment for your app including the location of the source files and the command to start the app within a container.
+The `Dockerfile` file describes the environment for your app including the location of the source files and the command to start the app within a container.
 
 > **Tip:** Containers versus images: A container is an instance of an image.
 
-Open the **Command Palette** (CTRL + SHIFT + P) and run **Docker: Build Image** to build the image. Choose the `Dockerfile` that was just created then give the image a name. It's important that you specify a couple of things here, the format is as follows:
+Open the **Command Palette** (CTRL + SHIFT + P) and run **Docker: Build Image** to build the image. Choose the `Dockerfile` file then give the image a name. It's important that you specify a couple of things here. The format is as follows:
 
 `[registry or username]/[image name]:[tag]`
 
-This tutorial uses the Azure Container Registry so for my example:
+This quickstart uses the Azure Container Registry so for my example:
 
 `fiveisprime.azurecr.io/myexpressapp:latest`
 
 ![tag docker image](./media/tutorial-javascript-vscode/tag-image.png)
 
-If you are using Docker Hub, use your Docker Hub username, for example:
+If you're using Docker Hub, use your Docker Hub username, for example:
 
 `fiveisprime/myexpressapp:latest`
 
diff --git a/articles/app-service/containers/tutorial-javascript-vscode-create-registry.md b/articles/app-service/containers/tutorial-javascript-vscode-create-registry.md
@@ -10,17 +10,17 @@ ms.devlang: javascript
 ---
 # Using Container Registries
 
-You need a container registry to push your app image to once the image is built. Once your image is available in a container registry, you will deploy directly from that registry.
+You need a container registry to push your app image to once the image is built. Once your image is available in a container registry, you'll deploy directly from that registry.
 
 ## Using Azure Container Registry
 
-[Azure Container Registry](https://azure.microsoft.com/en-us/services/container-registry/) (ACR) is a private, secure, hosted registry for your images. ACR is used in this tutorial, however ACR uses all the same tools and processes as other registry options so the steps are consistent regardless.
+[Azure Container Registry](https://azure.microsoft.com/en-us/services/container-registry/) (ACR) is a private, secure, hosted registry for your images. ACR is used in this tutorial, but the steps are the same for other registry services.
 
 Create an Azure Container Registry by signing in to the [Azure portal](https://portal.azure.com) then selecting **Create a resource** > **Containers** > **Container Registry**.
 
 ![Dashboard](./media/tutorial-javascript-vscode/qs-portal-01.png)
 
-Enter values for **Registry name** and **Resource group**. The registry name must be unique within Azure and contain 5-50 alphanumeric characters. For this tutorial select **'Basic'** for the **SKU**. Select **Create** to deploy the ACR instance.
+Enter values for **Registry name** and **Resource group**. The registry name must be unique within Azure and contain 5-50 alphanumeric characters. For this quickstart, select **'Basic'** for the **SKU**. Select **Create** to deploy the ACR instance.
 
 ![Creation](./media/tutorial-javascript-vscode/qs-portal-03.png)
 
@@ -39,7 +39,7 @@ Login Succeeded
 
 ## Using Docker Hub
 
-Docker Hub is Docker's own hosted registry that provides a free way of sharing images. Sign up for a Docker ID on [Docker Hub](https://hub.docker.com/) then login to the Docker CLI using your Docker ID credentials.
+Docker Hub is Docker's own hosted registry that provides a free way of sharing images. Sign up for a Docker ID on [Docker Hub](https://hub.docker.com/), then sign in to the Docker CLI using your Docker ID credentials.
 
 ## Prerequisite Check
 
diff --git a/articles/app-service/containers/tutorial-javascript-vscode-deploy-container.md b/articles/app-service/containers/tutorial-javascript-vscode-deploy-container.md
@@ -14,23 +14,23 @@ Now that you have your app image built and pushed to a registry, you can deploy
 
 ## Deploy the image
 
-Find the image under the **Registries** node in the **DOCKER** explorer, right click the `:latest` tag and choose **Deploy Image to Azure App Service**.
+Find the image under the **Registries** node in the **DOCKER** explorer, right-click the `:latest` tag, and choose **Deploy Image to Azure App Service**.
 
 ![Deploy From the Explorer](./media/tutorial-javascript-vscode/deploy-menu.png)
 
-From here follow the prompts. Set up a Resource Group in `West US` and App Service Plan. For this tutorial, use 'myResourceGroup' and 'myPlan' for the Resource Group and plan names then give your app a **unique** name.
+From here, follow the prompts. Set up a Resource Group in `West US` and App Service Plan. For this quickstart, use 'myResourceGroup' and 'myPlan' for the Resource Group and plan names then give your app a **unique** name.
 
 Once created, your app is accessible via http://**unique-name**.azurewebsites.net. In this example, I called it `myExpressApp4321`.
 
 ![Create and Deploy](./media/tutorial-javascript-vscode/create.gif)
 
 A **Resource Group** is essentially a named collection of all our application's resources in Azure. For example, a Resource Group can contain a reference to a website, a database, and an Azure Function.
 
-An **App Service Plan** defines the physical resources that will be used to host our website. In this walkthrough, we will use a **Basic** hosting plan on **Linux** infrastructure, which means the site will be hosted on a Linux machine alongside other websites. You can scale up and be the only site running on a machine later in the Azure Portal.
+An **App Service Plan** defines the physical resources that will be used to host our website. In this quickstart, we'll use a **Basic** hosting plan on **Linux** infrastructure, which means the site will be hosted on a Linux machine alongside other websites. You can scale up and be the only site running on a machine later in the Azure portal.
 
 ## Browse the website
 
-The Output panel will open during deployment to indicate the status of the operation. Once completed, find the app that you just created in the **AZURE APP SERVICE** explorer, right-click, and choose **Browse Website** to open the site in your browser.
+The **Output** panel will open during deployment to indicate the status of the operation. When the operation completes, find the app you created in the **AZURE APP SERVICE** explorer, right-click it, then choose **Browse Website** to open the site in your browser.
 
 ----
 
diff --git a/articles/app-service/containers/tutorial-javascript-vscode-get-started.md b/articles/app-service/containers/tutorial-javascript-vscode-get-started.md
@@ -10,7 +10,7 @@ ms.devlang: javascript
 ---
 # Deploy to Azure using Docker
 
-This tutorial walks you through containerizing an existing Node.js application using [Docker](https://www.docker.com/), pushing the app image to a Docker registry, then deploying the image to [Azure Web App for Containers](https://azure.microsoft.com/en-us/services/app-service/containers/) directly from Visual Studio Code.
+This quickstart shows you how to containerize an existing Node.js application using [Docker](https://www.docker.com/), then use Visual Studio Code to push the app image to a Docker registry and deploy it to [Azure Web App for Containers](https://azure.microsoft.com/en-us/services/app-service/containers/).
 
 ## Prerequisites
 
@@ -20,7 +20,7 @@ You need [Visual Studio Code](https://code.visualstudio.com/) installed along wi
 
 ## Install the Docker and Azure App Service extensions
 
-The Docker extension is used to simplify the management of local Docker images and commands as well as the deployment of a built app image to Azure.
+The Docker extension is used to simplify the management of local Docker images and commands and to deploy built app images to Azure.
 
 > <a class="tutorial-install-extension-btn" href="vscode:extension/PeterJausovec.vscode-docker">Install the Docker extension</a>
 
diff --git a/articles/app-service/containers/tutorial-javascript-vscode-tail-logs.md b/articles/app-service/containers/tutorial-javascript-vscode-tail-logs.md
@@ -20,7 +20,7 @@ When prompted, choose to enable logging and restart the application. Once the ap
 
 ![Enable Logging and Restart](./media/tutorial-javascript-vscode/enable-restart.png)
 
-After a few seconds, you will see a message indicating that you are connected to the log-streaming service.
+After a few seconds, you'll see a message indicating that you're connected to the log-streaming service.
 
 ```bash
 Connecting to log-streaming service...
@@ -39,7 +39,7 @@ Refresh the page a few times in the browser to see log output.
 
 ## Congratulations!
 
-Congratulations, you've successfully completed this walkthrough!
+Congratulations, you've successfully completed this quickstart!
 
 ## Other Azure extensions
 
@@ -48,7 +48,7 @@ Next, check out the other Azure extensions.
 * [Cosmos DB](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-cosmosdb)
 * [Azure Functions](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions)
 * [Azure CLI Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azurecli)
-* [Azure Resource Manager (ARM) Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools)
+* [Azure Resource Manager Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools)
 
 Or get them all by installing the
 [Node Pack for Azure](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension pack.
diff --git a/articles/app-service/tutorial-javascript-vscode-create-app.md b/articles/app-service/tutorial-javascript-vscode-create-app.md
@@ -10,14 +10,14 @@ ms.devlang: javascript
 ---
 # Create your Node.js application
 
-Next, create a simple Node.js application that can be deployed to the Cloud. This tutorial uses an application generator to quickly scaffold out the application from a terminal.
+Next, create a Node.js application that can be deployed to the Cloud. This tutorial uses an application generator to quickly scaffold out the application from a terminal.
 
 > **Tip:** If you have already completed the [Node.js tutorial](/docs/nodejs/nodejs-tutorial.md), you can skip ahead to [Deploy the Website](/tutorials/app-service-extension/deploy-app.md).
 
 ## Install the Express generator
 
-[Express](https://www.expressjs.com) is an extremely popular framework for building and running Node.js applications. You can scaffold (create) a new
-Express application using the [Express Generator](https://expressjs.com/en/starter/generator.html) tool. The Express Generator is shipped as an npm module and installed by using the npm command line tool `npm`.
+[Express](https://www.expressjs.com) is a popular framework for building and running Node.js applications. You can scaffold (create) a new
+Express application using the [Express Generator](https://expressjs.com/en/starter/generator.html) tool. The Express Generator is shipped as an npm module and installed by using the npm command-line tool `npm`.
 
 ```bash
 $ npm install -g express-generator
diff --git a/articles/app-service/tutorial-javascript-vscode-get-started.md b/articles/app-service/tutorial-javascript-vscode-get-started.md
@@ -10,7 +10,7 @@ ms.devlang: javascript
 ---
 # Deploy to Azure using App Service
 
-This tutorial walks you through deploying a Node.js application to Azure using the [Azure App Service extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). You'll be able to deploy to Azure on Linux in a matter of minutes from Visual Studio Code.
+This tutorial walks you through deploying a Node.js application to Azure using the [Azure App Service extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). You can deploy to Azure on Linux in a matter of minutes from Visual Studio Code.
 
 ## Prerequisites
 
@@ -32,7 +32,7 @@ Once the extension is installed, log into your Azure account - in the Activity B
 
 ## Troubleshooting
 
-If you see the error **"Cannot find subscription with name [subscription ID]"**, this may be because you are behind a proxy and unable to reach the Azure API. Configure `HTTP_PROXY` and `HTTPS_PROXY` environment variables with your proxy information in your terminal using `export`.
+If you see the error **"Cannot find subscription with name [subscription ID]"**, it might be because you're behind a proxy and unable to reach the Azure API. Configure `HTTP_PROXY` and `HTTPS_PROXY` environment variables with your proxy information in your terminal using `export`.
 
 ```sh
 export HTTPS_PROXY=https://username:password@proxy:8080
diff --git a/articles/app-service/tutorial-javascript-vscode-tail-logs.md b/articles/app-service/tutorial-javascript-vscode-tail-logs.md
@@ -20,7 +20,7 @@ When prompted, choose to enable logging and restart the application. Once the ap
 
 ![Enable Logging and Restart](./media/tutorial-javascript-vscode/enable-restart.png)
 
-After a few seconds, you will see a message indicating that you are connected to the log-streaming service.
+After a few seconds, you'll see a message indicating that you're connected to the log-streaming service.
 
 ```bash
 Connecting to log-streaming service...
@@ -39,7 +39,7 @@ Refresh the page a few times in the browser to see log output.
 
 ## Congratulations!
 
-Congratulations, you've successfully completed this walkthrough!
+Congratulations, you've successfully completed this quickstart!
 
 ## Other Azure extensions
 
@@ -49,7 +49,7 @@ Next, check out the other Azure extensions.
 * [Azure Functions](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions)
 * [Docker Tools](https://marketplace.visualstudio.com/items?itemName=PeterJausovec.vscode-docker)
 * [Azure CLI Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azurecli)
-* [Azure Resource Manager (ARM) Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools)
+* [Azure Resource Manager Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools)
 
 Or get them all by installing the
 [Node Pack for Azure](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension pack.
diff --git a/articles/azure-functions/tutorial-javascript-vscode-deploy-app.md b/articles/azure-functions/tutorial-javascript-vscode-deploy-app.md
@@ -12,7 +12,7 @@ ms.devlang: javascript
 
 If you don't have an Azure account, [sign up today](https://azure.microsoft.com/en-us/free/serverless?utm_source=campaign&utm_campaign=vscode-tutorial-functions-extension&mktingSource=vscode-tutorial-functions-extension) for a free account with $200 in Azure credits to try out any combination of services.
 
-Once created, log in to your Azure account - in the Activity Bar, click on the Azure logo to show the **Azure Functions** explorer. Click **Sign in to Azure...** and choose your account in the browser.
+Once created, sign in to your Azure account - in the Activity Bar, click on the Azure logo to show the **Azure Functions** explorer. Click **Sign in to Azure...** and choose your account in the browser.
 
 ![sign in to Azure](./media/tutorial-javascript-vscode/sign-in.png)
 
@@ -22,7 +22,7 @@ In the **AZURE FUNCTIONS** explorer, click the blue up arrow icon to deploy your
 
 > **Tip:** You can also deploy from the **Command Palette** (CTRL + SHIFT + P) by typing 'deploy to function app' and running the **Azure Functions: Deploy to Function App** command.
 
-From here follow the prompts. Choose the directory that you currently have open, select your Azure subscription, and then choose **Create New Function App**.
+From here, follow the prompts. Choose the directory that you currently have open, select your Azure subscription, and then choose **Create New Function App**.
 
 1. Type a globally unique name for your Function App and press ENTER. Valid characters for a function app name are 'a-z', '0-9', and '-'.
 
@@ -42,27 +42,27 @@ The Output panel shows the Azure resources that were created in your subscriptio
 
 ## Browse the website
 
-The Output panel will open during deployment to indicate the status of the operation. Once completed, find the app that you just created in the **AZURE FUNCTIONS** explorer, expand the **Functions** node to expose the HttpTriggerJS function, then right-click and choose **Copy Function Url**. Paste the URL into your browser along add the `?name=Matt` query parameter and press ENTER to see the response.
+The **Output** panel will open during deployment to indicate the status of the operation. When the operation completes, find the app you created in the **AZURE FUNCTIONS** explorer. Then, expand the **Functions** node to expose the HttpTriggerJS function, right-click it, and choose **Copy Function Url**. Paste the URL into your browser along add the `?name=Matt` query parameter and press ENTER to see the response.
 
 ![Deploy to Functions](./media/tutorial-javascript-vscode/functions-test-remote-browser.png)
 
 ## Updating the App
 
-Next, make some changes to your Function and add new Functions with other Triggers. Once you have all the source code running correctly in your local environment, click the blue up arrow **Deploy to Function App** button to deploy your changes.
+Next, make some changes to your Function and add new Functions with other Triggers. When you have the code running correctly in your local environment, click the blue up arrow **Deploy to Function App** button to deploy your changes.
 
 > **Tip:** When deploying, the entire Functions application is deploy so changes to all individual Functions will be deployed at once.
 
 ## Congratulations!
 
-Congratulations, you've successfully completed this walkthrough!
+Congratulations, you've successfully completed this quickstart!
 
 Next, check out the other Azure extensions.
 
 * [Azure App Service](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice)
 * [Cosmos DB](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-cosmosdb)
 * [Docker Tools](https://marketplace.visualstudio.com/items?itemName=PeterJausovec.vscode-docker)
 * [Azure CLI Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azurecli)
-* [Azure Resource Manager (ARM) Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools)
+* [Azure Resource Manager Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools)
 
 Or get them all by installing the
 [Node Pack for Azure](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-node-azure-pack) extension pack.
diff --git a/articles/azure-functions/tutorial-javascript-vscode-get-started.md b/articles/azure-functions/tutorial-javascript-vscode-get-started.md
@@ -10,7 +10,7 @@ ms.devlang: javascript
 ---
 # Deploy to Azure using Azure Functions
 
-This tutorial walks you through creating and deploying a JavaScript Azure Functions application using the [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions). Create a new app, add functions and deploy in a matter of minutes from Visual Studio Code.
+This tutorial walks you through creating and deploying a JavaScript Azure Functions application using the [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions). Create a new app, add functions, and deploy in a matter of minutes from Visual Studio Code.
 
 ## Prerequisites
 
diff --git a/articles/azure-functions/tutorial-javascript-vscode-run-app.md b/articles/azure-functions/tutorial-javascript-vscode-run-app.md
