Edits

Author: dksimpson

articles/cognitive-services/Bing-Web-Search/quickstarts/csharp.md

@@ -18,7 +18,7 @@ ms.custom: seodec2018
 
 Use this quickstart to make your first call to the Bing Web Search API. This C# application sends a search request to the API, and shows the JSON response. Although this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
 
-This example program only uses .NET Core classes.
+This example program in this quickstart uses only .NET Core classes.
 
 ## Prerequisites
 
@@ -58,7 +58,13 @@ namespace BingSearchApisQuickstart
 
 ## Define variables
 
-A few variables must be set before we can continue. You can use the value of `uriBase` in the following code for the global endpoint, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Confirm that `uriBase` is valid and replace the `accessKey` value with a valid subscription key from your Azure account. You can customize the search query by replacing the value for `searchTerm`. Add this code to the `Program` class as noted in the previous section.
+A few variables must be set before we can continue. Add this code to the `Program` class you created in the previous section: 
+
+1. For the value of `uriBase` you can use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. 
+
+2. Confirm that `uriBase` is valid and replace the `accessKey` value with a subscription key from your Azure account. 
+
+3. Optionally, customize the search query by replacing the value for `searchTerm`. 
 
 ```csharp
 // Enter a valid subscription key.
@@ -76,7 +82,7 @@ const string searchTerm = "Microsoft Cognitive Services";
 
 The `Main()` method is required and is the first method invoked when you start the program. In this application, the main method  validates the `accessKey`, makes a request, and prints the response.
 
-Keep in mind that `main()` is dependent on methods that are created in the next few sections.
+Keep in mind that `main()` is dependent on methods that you create in the next few sections.
 
 ```csharp
 static void Main()
@@ -105,7 +111,7 @@ static void Main()
 
 ## Create a struct for search results
 
-This struct returns search results with relevant headers. It's called when making a request to the Bing Web Search API to create a result object.
+Create a struct that returns search results with relevant headers. You call it when you make a request to the Bing Web Search API to create a result object.
 
 ```csharp
 // Returns search results with headers.
@@ -154,7 +160,7 @@ static SearchResult BingWebSearch(string searchQuery)
 
 ## Format the response
 
-This method formats the JSON response, primarily indenting and adding line breaks.
+This method formats the JSON response, by primarily indenting and adding line breaks.
 
 ```csharp
 /// <summary>
@@ -362,6 +368,6 @@ Responses from the Bing Web Search API are returned as JSON. This sample respons
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/go.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 12/09/2019
+ms.date: 05/20/2020
 ms.author: aahi
 ms.reviewer: [email protected], v-gedod, erhopf
 ms.custom: seodec2018
@@ -17,21 +17,21 @@ ms.custom: seodec2018
 
 # Quickstart: Search the web using the Bing Web Search REST API and Go
 
-Use this quickstart to make your first call to the Bing Web Search API and receive the JSON response. This Go application sends a search request to the API, and shows the response. While this application is written in Go, the API is a RESTful Web service compatible with most programming languages.
+Use this quickstart to make your first call to the Bing Web Search API. This Go application sends a search request to the API, and shows the JSON response. Although this application is written in Go, the API is a RESTful Web service compatible with most programming languages.
+
+ The code examples in this quickstart require only core libraries; there are no external dependencies.  
 
 ## Prerequisites
 Here are a few things that you'll need before running this quickstart:
 
 * [Go binaries](https://golang.org/dl/)
 * A subscription key
 
-This quickstart only requires **core** libraries, there are no external dependencies.  
-
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]  
 
 ## Create a project and import core libraries
 
-Create a new Go project in your favorite IDE or editor. Then import `net/http` for requests, `ioutil` to read the response, `time` and `encoding/json` to handle the JSON, and `fmt` to print the output.
+Create a new Go project in your favorite IDE or editor. Then, import `net/http` for requests, `ioutil` to read the response, `time` and `encoding/json` to handle the JSON, and `fmt` to print the output.
 
 ```go
 package main
@@ -107,7 +107,13 @@ type BingAnswer struct {
 
 ## Declare the main function and define variables  
 
-This code declares the main function and sets required variables. `endpoint` can be the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. Feel free to customize the search query by replacing the value for `searchTerm`.
+This code declares the main function and sets the required variables: 
+
+1. For the value of `endpoint`, you can use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. 
+
+2. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. 
+ 
+3. Optionally, customize the search query by replacing the value for `searchTerm`.
 
 ```go
 // Declare the main function. This is required for all Go programs.
@@ -166,7 +172,7 @@ if err != nil {
 
 ## Handle the response
 
-Remember the struct we created earlier? We're going to use it to format the response and print the search results.
+We'll now use the struct we created previously to format the response and print the search results.
 
 ```go
 // Create a new answer.  
@@ -183,7 +189,7 @@ for _, result := range ans.WebPages.Value {
 
 ## Put it all together
 
-The last step is to validate your code and run it! If you'd like to compare your code with ours, here's the complete program:
+The last step is to validate your code and run it. If you'd like to compare your code with ours, here's the complete program:
 
 ```go
 package main
@@ -301,7 +307,7 @@ func main() {
 }
 ```
 
-## Sample response  
+## Example JSON response
 
 Responses from the Bing Web Search API are returned as JSON. This sample response has been formatted using the `BingAnswer` struct and shows the `result.Name` and `result.URL`.
 
@@ -320,6 +326,6 @@ Cognitive Services - msdn.microsoft.com || https://msdn.microsoft.com/magazine/m
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/java.md

@@ -69,7 +69,13 @@ public class BingWebSearch {
 
 ## Define variables
 
-This code sets the `subscriptionKey`, `host`, `path`, and `searchTerm`. You can use the value of `host` in the following code for the global endpoint, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Replace the `subscriptionKey` value with a valid subscription key from your Azure account. You can customize the search query by replacing the value for `searchTerm`. Add this code to the `BingWebSearch` class as noted in the previous section.
+The following code sets the `subscriptionKey`, `host`, `path`, and `searchTerm`. Add this code to the `BingWebSearch` class described in the previous section:
+
+1. For the value of `host`, you can use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. 
+
+2. Replace the `subscriptionKey` value with a valid subscription key from your Azure account. 
+
+3. Optionally, customize the search query by replacing the value for `searchTerm`. 
 
 ```java
 // Enter a valid subscription key.
@@ -87,7 +93,7 @@ static String searchTerm = "Microsoft Cognitive Services";
 
 ## Construct a request
 
-This method, which is included in the `BingWebSearch` class, constructs the `url`, receives and parses the response, and extracts Bing-related HTTP headers.  
+The `SsearchWeb()` method, which is included in the `BingWebSearch` class, constructs the `url`, receives and parses the response, and extracts Bing-related HTTP headers.  
 
 ```java
 public static SearchResults SearchWeb (String searchQuery) throws Exception {
@@ -163,7 +169,7 @@ public static void main (String[] args) {
 
 ## Create a container class for search results
 
-The `SearchResults` container class is outside of the `BingWebSearch` class. It includes relevant headers and JSON data for the response.
+The `SearchResults` container class is defined outside of the `BingWebSearch` class. It includes relevant headers and JSON data for the response.
 
 ```java
 class SearchResults{

articles/cognitive-services/Bing-Web-Search/quickstarts/nodejs.md

@@ -29,7 +29,7 @@ Here are a few things that you'll need before running this quickstart:
 
 ## Create a project and declare required modules
 
-Create a new Node.js project in your favorite IDE or editor. Then, copy the following code snippet to your project in a file named `search.js`:
+Create a new Node.js project in your favorite IDE or editor. Then, copy the following code snippet to your project in a file named search.js:
 
 ```javascript
 // Use this simple app to query the Bing Web Search API and get a JSON response.
@@ -52,9 +52,15 @@ if (!SUBSCRIPTION_KEY) {
 
 ## Create a function to make the request
 
-This function makes a secure GET request and saves the search query as a query parameter in the path. You can use the value of `hostname` in the following code for the global endpoint, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.  
+This function makes a secure GET request and saves the search query as a query parameter in the path. 
 
-In this function, `encodeURIComponent` is used to escape invalid characters, and the subscription key is passed in a header. The callback receives a [response](https://nodejs.org/dist/latest-v10.x/docs/api/http.html#http_class_http_serverresponse) that subscribes to the `data` event to aggregate the JSON body, the `error` event to log any issues, and the `end` event to know when the message should be considered complete. When complete, the app prints the interesting headers and message body. You can adjust the colors and set the depth to suit your preference. A depth of `1` gives a nice summary of the response.
+1. For the value of `hostname`, you can use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.  
+
+2. Use `encodeURIComponent` to escape invalid characters. The subscription key is passed in a header. 
+
+3. The callback receives a [response](https://nodejs.org/dist/latest-v10.x/docs/api/http.html#http_class_http_serverresponse) that subscribes to the `data` event to aggregate the JSON body, the `error` event to log any issues, and the `end` event to know when the message should be considered complete. 
+
+4. When the app is complete, it prints the interesting headers and message body. You can adjust the colors and set the depth to suit your preference. A depth of `1` gives a nice summary of the response.
 
 ```javascript
 function bingWebSearch(query) {
@@ -100,7 +106,7 @@ bingWebSearch(query)
 
 ## Put it all together
 
-The last step is to run your code: `node search.js "<your query>"`.
+The last step is to run your code with the command: `node search.js "<your query>"`.
 
 If you'd like to compare your code with ours, here's the complete program:
 
@@ -266,6 +272,6 @@ Responses from the Bing Web Search API are returned as JSON. This sample respons
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/php.md

@@ -16,7 +16,7 @@ ms.custom: seodec2018
 
 # Quickstart: Use PHP to call the Bing Web Search API  
 
-Use this quickstart to make your first call to the Bing Web Search API and receive the JSON response. This Node.js application sends a search request to the API, and shows the response. While this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages.
+Use this quickstart to make your first call to the Bing Web Search API. This Node.js application sends a search request to the API, and shows the JSON response. Although this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -37,9 +37,13 @@ Before we get started, locate `php.ini` and uncomment this line:
 
 ## Create a project and define variables
 
-Create a new PHP project in your favorite IDE or editor. Don't forget to add opening and closing tags `<?php` and `?>`.
+1. Create a new PHP project in your favorite IDE or editor. Add opening and closing tags: `<?php` and `?>`.
 
-A few variables must be set before we can continue. `$endpoint` can be the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Confirm that the `$endpoint` is correct and replace the `$accesskey` value with a valid subscription key from your Azure account. Feel free to customize the search query by replacing the value for `$term`.
+2. For the value of `$endpoint`, you can use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. 
+
+3. Confirm that the `$endpoint` value is correct and replace the `$accesskey` value with a valid subscription key from your Azure account. 
+
+4. Optionally, customize the search query by replacing the value for `$term`.
 
 ```php
 $accessKey = 'enter key here';
@@ -49,7 +53,7 @@ $term = 'Microsoft Cognitive Services';
 
 ## Construct a request
 
-This code declares a function called `BingWebSearch` that is used to construct requests to the Bing Web Search API. It takes three arguments: `$url`, `$key`, and `$query`.
+This code declares a function called `BingWebSearch` that's used to construct requests to the Bing Web Search API. It takes three arguments: `$url`, `$key`, and `$query`.
 
 ```php
 function BingWebSearch ($url, $key, $query) {
@@ -109,7 +113,7 @@ if (strlen($accessKey) == 32) {
 
 ## Put it all together
 
-The last step is to validate your code and run it! If you'd like to compare your code with ours, here's the complete program:
+The last step is to validate your code and run it. If you'd like to compare your code with ours, here's the complete program:
 
 ```php
 <?php
@@ -280,6 +284,6 @@ Responses from the Bing Web Search API are returned as JSON. This sample respons
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/python.md

@@ -87,6 +87,6 @@ To run this code locally, see the complete [sample available on GitHub](https://
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/ruby.md

@@ -39,7 +39,13 @@ require 'json'
 
 ## Define variables
 
-A few variables must be set before we can continue. You can use the value of `uri` in the following code for the global endpoint, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Confirm that `uri` and `path` are valid and replace the `accessKey` value with a valid subscription key from your Azure account. Feel free to customize the search query by replacing the value for `term`.
+A few variables must be set before we can continue:
+
+1. For the value of `uri`, you can use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. 
+
+2. Confirm that the `uri` and `path` values are valid and replace the `accessKey` value with a subscription key from your Azure account. 
+
+3. Optionally, customize the search query by replacing the value for `term`.
 
 ```ruby
 accessKey = "YOUR_SUBSCRIPTION_KEY"
@@ -260,6 +266,6 @@ Responses from the Bing Web Search API are returned as JSON. This sample respons
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

includes/bing-web-search-quickstart-see-also.md

@@ -3,9 +3,9 @@ author: erikhopf
 ms.author: erhopf
 ms.service: cognitiveservices
 ms.topic: include
-ms.date: 08/16/2018
+ms.date: 05/20/2020
 ---
 ## See also
 
-* [Bing Web Search API overview](../articles/cognitive-services/Bing-Web-Search/overview.md)
+* [What is the Bing Web Search API?](../articles/cognitive-services/Bing-Web-Search/overview.md)
 * [Bing Web Search API v7 reference](https://docs.microsoft.com/rest/api/cognitiveservices/bing-web-api-v7-reference)