Refresh Bing News Search REST API quickstarts

Author: dksimpson

articles/cognitive-services/Bing-News-Search/csharp.md

@@ -8,28 +8,28 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-news-search
 ms.topic: quickstart
-ms.date: 12/12/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ms.custom: seodec2018
 ---
 
 # Quickstart: Search for news using C# and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing News Search API and view the JSON response. This simple C# application sends a news search query to the API, and displays the response. The full code to this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingNewsSearchv7.cs).
+Use this quickstart to make your first call to the Bing News Search API. This simple C# application sends a news search query to the API, and displays the JSON response. The full code to this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingNewsSearchv7.cs).
 
-While this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
 * Any edition of [Visual Studio 2017 or later](https://www.visualstudio.com/downloads/).
 * The [Json.NET](https://www.newtonsoft.com/json) framework, available as a NuGet package.
-* If you are using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
+* If you're using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create and initialize a project
 
-1. create a new C# console solution in Visual Studio. Then add the following namespaces into the main code file.
+1. Create a new C# console solution in Visual Studio. Then, add the following namespaces into the main code file:
 
     ```csharp
     using System;
@@ -39,7 +39,7 @@ While this application is written in C#, the API is a RESTful Web service compat
     using System.Collections.Generic;
     ```
 
-2. Create variables for the API endpoint, your subscription key, and search term. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create variables for the API endpoint, your subscription key, and search term. 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.
 
     ```csharp
     const string accessKey = "enter key here";
@@ -48,7 +48,7 @@ While this application is written in C#, the API is a RESTful Web service compat
     ```
    ## Create a struct to format the Bing News Search response
 
-1. Define a `SearchResult` struct to contain the image search results, and JSON header information.
+1. Define a `SearchResult` struct to contain the image search results and JSON header information.
 
     ```csharp
     struct SearchResult
@@ -60,9 +60,9 @@ While this application is written in C#, the API is a RESTful Web service compat
 
 ## Create and handle a news search request
 
-Create a method named `BingNewsSearch` to perform the call to the API, and set the return type to the `SearchResult` struct created earlier. In the method, perform the following steps:
+Create a method named `BingNewsSearch` to perform the call to the API, and set the return type to the `SearchResult` struct created previously. In the method, do the following steps:
 
-1. Construct the URI for the search request. Note that the search term `toSearch` must be formatted before being appended to the string.
+1. Construct the URI for the search request. The `toSearch` search term must be formatted before it's appended to the string.
 
     ```csharp
     static SearchResult BingNewsSearch(string toSearch){
@@ -80,7 +80,7 @@ Create a method named `BingNewsSearch` to perform the call to the API, and set t
     string json = new StreamReader(response.GetResponseStream()).ReadToEnd();
     ```
 
-3. Create the search result object, and extract the Bing HTTP headers. Then return `searchResult`.
+3. Create the search result object, and extract the Bing HTTP headers. Then, return `searchResult`.
 
     ```csharp
     // Create the result object for return
@@ -101,7 +101,7 @@ Create a method named `BingNewsSearch` to perform the call to the API, and set t
 
 ## Process the response
 
-1. In the main method, call `BingNewsSearch()` and store the returned response. Then deserialize the JSON into an object. You can then view the values of the response.
+In the main method, call `BingNewsSearch()` and store the returned response. Then deserialize the JSON into an object. You can then view the values of the response.
 
     ```csharp
     SearchResult result = BingNewsSearch(searchTerm);

articles/cognitive-services/Bing-News-Search/go.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ---
 
@@ -19,14 +19,13 @@ This quickstart uses the Go language to call the Bing News Search API. The resul
 
 ## Prerequisites
 * Install the [Go binaries](https://golang.org/dl/)
-* Install the go-spew library for it pretty printer to display results
-    * Install this library: `$ go get -u https://github.com/davecgh/go-spew`
+* Install the go-spew library to use a deep pretty printer to display results. Use this command to install the library: `$ go get -u https://github.com/davecgh/go-spew`
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create a project and import libraries
 
-Create a new Go project in your IDE or editor. Then import `net/http` for requests, `ioutil` to read the response, and `encoding/json` to handle the JSON text of results. The go-spew library is needed to parse JSON. 
+Create a new Go project in your IDE or editor. Then, import `net/http` for requests, `ioutil` to read the response, and `encoding/json` to handle the JSON text of results. The go-spew library is needed to parse JSON. 
 
 ```go
 package main
@@ -43,7 +42,7 @@ import (
 
 ## Create a struct to format the News search results
 
-The `NewsAnswer` struct formats the data provided in the response. The response JSON is multilevel and quite complex.  The following implementation covers the essentials.
+The `NewsAnswer` struct formats the data provided in the response JSON, which is multilevel and complex. The following implementation covers the essentials:
 
 ```go
 // This struct formats the answer provided by the Bing News Search API.
@@ -83,7 +82,7 @@ type NewsAnswer struct {
 
 ## Declare the main function and define variables  
 
-The following code declares the main function and assigns required variables. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+The following code declares the main function and assigns required variables. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. 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.
 
 ```go
 func main() {
@@ -104,7 +103,7 @@ func main() {
 
 ## Query and header
 
-Add the query string and access key header
+Add the query string and access key header.
 
 ```go
 // Add the query to the request.  
@@ -135,7 +134,7 @@ if err != nil {
 
 ## Send the request
 
-Send the request and read results using `ioutil`.
+Send the request and read results by using `ioutil`.
 
 ```go
 resp, err := client.Do(req)
@@ -156,7 +155,7 @@ if err != nil {
 
 ## Handle the response
 
-The `Unmarshall` function extracts information from the JSON text returned by the News Search API.  Then you can display nodes from the results using the `go-spew` pretty printer.
+The `Unmarshall` function extracts information from the JSON text returned by the News Search API. Then, you can display nodes from the results by using the `go-spew` pretty printer.
 
 ```go
 // Create a new answer object 
@@ -177,7 +176,7 @@ spew.Dump(result.Name, result.URL)
 
 ## Results
 
-The results contain name and URL of each result.
+The following output contains the name and URL of each result:
 
 ```
 (string) (len=91) "Cognitive Services Market: Global Industry Analysis and Opportunity Assessment, 2019 - 2025"

articles/cognitive-services/Bing-News-Search/java.md

@@ -9,31 +9,30 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-news-search
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ms.custom: seodec2018
 ---
 
 # Quickstart: Perform a news search using Java and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing News Search API and view the JSON response. This simple Java application sends a news search query to the API, and displays the response.
+Use this quickstart to make your first call to the Bing News Search API. This simple Java application sends a news search query to the API, and displays the JSON response.
 
-While this application is written in Java, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in Java, the API is a RESTful Web service compatible with most programming languages.
 
-The source code for this sample is available [on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingNewsSearchv7.java) 
+The source code for this sample is available [on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingNewsSearchv7.java). 
 
 ## Prerequisites
 
-* The [Java Development Kit(JDK) 7 or 8](https://aka.ms/azure-jdks)
-
+* The [Java Development Kit (JDK) 7 or 8](https://aka.ms/azure-jdks)
 * The [Gson library](https://github.com/google/gson)
 
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create and initialize a project
 
-1. Create a new Java project in your favorite IDE or editor, and import the following libraries.
+1. Create a new Java project in your favorite IDE or editor, and import the following libraries:
 
     ```java
     import java.net.*;
@@ -46,7 +45,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     import com.google.gson.JsonParser;
     ```
 
-2. Create a new class, with variables for the API endpoint, your subscription key, and search term. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create a new class, with variables for the API endpoint, your subscription key, and search term. 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.
 
     ```java
     public static SearchResults SearchNews (String searchQuery) throws Exception {
@@ -60,7 +59,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
 
 ## Construct the search request, and receive a JSON response
 
-1. Use the variables from the last step to format a search URL for the API request. Note that your search term must be URL-encoded before being appended to the request.
+1. Use the variables from the previous step to format a search URL for the API request. URL-encode your search term before you append it to the request.
 
     ```java
     public static SearchResults SearchNews (String searchQuery) throws Exception {
@@ -71,7 +70,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     }
     ```
 
-2. Receive the JSON response from the Bing News Search API, and construct the result object.
+2. Receive the JSON response from the Bing News Search API and construct the result object.
 
     ```java
     // receive JSON body
@@ -84,6 +83,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
 ## Process the JSON response
 
 1. Separate the Bing-related HTTP headers from the JSON body, then close the stream and return the API response.
+
     ```java
     // extract Bing-related HTTP headers
     Map<String, List<String>> headers = connection.getHeaderFields();
@@ -97,7 +97,8 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     return results;
     ```
 
-2. Create a method to parse and reserialize JSON
+2. Create a method to parse and reserialize JSON.
+
     ```java
     // pretty-printer for JSON; uses GSON parser to parse and re-serialize
     public static String prettify(String json_text) {
@@ -108,7 +109,8 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     }
     ```
 
-3. In the main method of your application, call the search method, and display the results.
+3. In the main method of your application, call the search method and display the results.
+
     ```csharp
    public static void main (String[] args) {
        System.out.println("Searching the Web for: " + searchTerm);

articles/cognitive-services/Bing-News-Search/nodejs.md

@@ -8,36 +8,35 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-news-search
 ms.topic: quickstart
-ms.date: 12/12/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ms.custom: seodec2018
 ---
 # Quickstart: Perform a news search using Node.js and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing Image Search API and receive a JSON response. This simple JavaScript application sends a search query to the API and displays the raw results.
+Use this quickstart to make your first call to the Bing Image Search API. This simple JavaScript application sends a search query to the API and displays the JSON response.
 
-While this application is written in JavaScript and runs in Node.js, the API is a RESTful Web service compatible most programming languages.
+Although this application is written in JavaScript and runs in Node.js, the API is a RESTful Web service compatible with most programming languages.
 
 The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/nodejs/Search/BingNewsSearchv7.js).
 
 ## Prerequisites
 
 * The latest version of [Node.js](https://nodejs.org/en/download/).
-
-* The [JavaScript Request Library](https://github.com/request/request)
+* The [JavaScript Request Library](https://github.com/request/request).
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create and initialize the application
 
-1. Create a new JavaScript file in your favorite IDE or editor, and set the strictness and https requirements.
+1. Create a new JavaScript file in your favorite IDE or editor, and set the strictness and HTTPS requirements.
 
     ```javascript
     'use strict';
     let https = require('https');
     ```
 
-2. Create variables for the API endpoint, image API search path, your subscription key, and search term. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. 
+2. Create variables for the API endpoint, image API search path, your subscription key, and search term. 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. 
 
     ```javascript
     let subscriptionKey = 'enter key here';
@@ -48,36 +47,38 @@ The source code for this sample is available on [GitHub](https://github.com/Azur
 
 ## Handle and parse the response
 
-1. define a function named `response_handler` that takes an HTTP call, `response`, as a parameter. within this function, perform the following steps:
+1. Define a function, named `response_handler`, that takes an HTTP call, `response`, as a parameter. 
 
-    1. Define a variable to contain the body of the JSON response.  
-        ```javascript
-        let response_handler = function (response) {
-            let body = '';
-        };
-        ```
+2. Within this function, define a variable to contain the body of the JSON response.  
 
-    2. Store the body of the response when the **data** flag is called
-        ```javascript
-        response.on('data', function (d) {
-            body += d;
-        });
+    ```javascript
+    let response_handler = function (response) {
+        let body = '';
+    };
         ```
 
-    3. When an **end** flag is signaled, the JSON and headers can be viewed.
-
-        ```javascript
-        response.on('end', function () {
-            console.log('\nRelevant Headers:\n');
-            for (var header in response.headers)
-                // header keys are lower-cased by Node.js
-                if (header.startsWith("bingapis-") || header.startsWith("x-msedge-"))
-                     console.log(header + ": " + response.headers[header]);
-            body = JSON.stringify(JSON.parse(body), null, '  ');
-            console.log('\nJSON Response:\n');
-            console.log(body);
-         });
-        ```
+3. Store the body of the response when the `data` flag is called.
+
+    ```javascript
+    response.on('data', function (d) {
+        body += d;
+    });
+    ```
+
+3. When an `end` flag is signaled, the JSON and headers can be viewed.
+
+    ```javascript
+    response.on('end', function () {
+        console.log('\nRelevant Headers:\n');
+        for (var header in response.headers)
+            // header keys are lower-cased by Node.js
+            if (header.startsWith("bingapis-") || header.startsWith("x-msedge-"))
+                 console.log(header + ": " + response.headers[header]);
+        body = JSON.stringify(JSON.parse(body), null, '  ');
+        console.log('\nJSON Response:\n');
+        console.log(body);
+     });
+    ```
 
 ## JSON Response