Edits

dksimpson · dksimpson · commit a10ac6274a9d · 2020-05-14T12:32:57.000-07:00
diff --git a/articles/cognitive-services/Bing-News-Search/csharp.md b/articles/cognitive-services/Bing-News-Search/csharp.md
@@ -15,10 +15,12 @@ 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. 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).
+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. 
 
 Although this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
 
+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).
+
 ## Prerequisites
 
 * Any edition of [Visual Studio 2017 or later](https://www.visualstudio.com/downloads/).
@@ -29,7 +31,7 @@ Although this application is written in C#, the API is a RESTful Web service com
 
 ## 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 to the main code file:
     
     ```csharp
     using System;
@@ -61,44 +63,46 @@ struct SearchResult
 
 ## Create and handle a news search request
 
-1. 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. Create a method named `BingNewsSearch()` to perform the call to the API, and set the return type to the `SearchResult` struct created previously. 
 
-   1. Construct the URI for the search request. The `toSearch` search term must be formatted before it's appended to the string.
+   Add code to this method in the steps that follow.
 
-       ```csharp
-       static SearchResult BingNewsSearch(string toSearch){
+1. Construct the URI for the search request. The `toSearch` search term must be formatted before it's appended to the string.
 
-           var uriQuery = uriBase + "?q=" + Uri.EscapeDataString(toSearch);
-       //...
-       ```
+    ```csharp
+    static SearchResult BingNewsSearch(string toSearch){
 
-   1. Perform the web request and get the response as a JSON string.
+        var uriQuery = uriBase + "?q=" + Uri.EscapeDataString(toSearch);
+    //...
+    ```
 
-       ```csharp
-       WebRequest request = WebRequest.Create(uriQuery);
-       request.Headers["Ocp-Apim-Subscription-Key"] = subscriptionKey;
-       HttpWebResponse response = (HttpWebResponse)request.GetResponseAsync().Result;
-       string json = new StreamReader(response.GetResponseStream()).ReadToEnd();
-       ```
+1. Perform the web request and get the response as a JSON string.
 
-   1. Create the search result object, and extract the Bing HTTP headers. Then, return `searchResult`.
+    ```csharp
+    WebRequest request = WebRequest.Create(uriQuery);
+    request.Headers["Ocp-Apim-Subscription-Key"] = subscriptionKey;
+    HttpWebResponse response = (HttpWebResponse)request.GetResponseAsync().Result;
+    string json = new StreamReader(response.GetResponseStream()).ReadToEnd();
+    ```
 
-       ```csharp
-       // Create the result object for return
-       var searchResult = new SearchResult()
-       {
-           jsonResult = json,
-           relevantHeaders = new Dictionary<String, String>()
-       };
+1. Create the search result object, and extract the Bing HTTP headers. Then, return `searchResult`.
 
-       // Extract Bing HTTP headers
-       foreach (String header in response.Headers)
-       {
-           if (header.StartsWith("BingAPIs-") || header.StartsWith("X-MSEdge-"))
-               searchResult.relevantHeaders[header] = response.Headers[header];
-       }
-       return searchResult;
-       ```
+    ```csharp
+    // Create the result object for return
+    var searchResult = new SearchResult()
+    {
+        jsonResult = json,
+        relevantHeaders = new Dictionary<String, String>()
+    };
+
+    // Extract Bing HTTP headers
+    foreach (String header in response.Headers)
+    {
+        if (header.StartsWith("BingAPIs-") || header.StartsWith("X-MSEdge-"))
+            searchResult.relevantHeaders[header] = response.Headers[header];
+    }
+    return searchResult;
+    ```
 
 ## Process the response
 
diff --git a/articles/cognitive-services/Bing-News-Search/go.md b/articles/cognitive-services/Bing-News-Search/go.md
@@ -18,14 +18,14 @@ ms.author: aahi
 This quickstart uses the Go language to call the Bing News Search API. The results include names and URLs of news sources identified by the query string.
 
 ## Prerequisites
-* Install the [Go binaries](https://golang.org/dl/)
-* 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`
+* Install the [Go binaries](https://golang.org/dl/).
+* Install the go-spew library to use a deep pretty printer to display the 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, `encoding/json` to handle the JSON text of results, and the go-spew library to parse the JSON results. 
 
 ```go
 package main
@@ -40,7 +40,7 @@ import (
 
 ```
 
-## Create a struct to format the News search results
+## Create a struct to format the news search results
 
 The `NewsAnswer` struct formats the data provided in the response JSON, which is multilevel and complex. The following implementation covers the essentials:
 
@@ -82,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 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.
+The following code declares the main function and assigns the required variables. Confirm that the endpoint is correct, and then 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() {
@@ -134,7 +134,7 @@ if err != nil {
 
 ## Send the request
 
-Send the request and read results by using `ioutil`.
+Send the request and read the results by using `ioutil`.
 
 ```go
 resp, err := client.Do(req)
@@ -155,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 by using the `go-spew` pretty printer.
+The `Unmarshall` function extracts information from the JSON text returned by the Bing News Search API. Then, display nodes from the results with the `go-spew` pretty printer.
 
 ```go
 // Create a new answer object 
diff --git a/articles/cognitive-services/Bing-News-Search/java.md b/articles/cognitive-services/Bing-News-Search/java.md
@@ -97,7 +97,7 @@ 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 the JSON results.
 
     ```java
     // pretty-printer for JSON; uses GSON parser to parse and re-serialize
diff --git a/articles/cognitive-services/Bing-News-Search/nodejs.md b/articles/cognitive-services/Bing-News-Search/nodejs.md
@@ -49,7 +49,9 @@ The source code for this sample is available on [GitHub](https://github.com/Azur
 
 1. Define a function named `response_handler` that takes an HTTP call, `response`, as a parameter. 
 
-2. Within this function, define a variable to contain the body of the JSON response.  
+   Add code to this function in the steps that follow.
+
+2. Define a variable to contain the body of the JSON response.  
 
     ```javascript
     let response_handler = function (response) {
diff --git a/articles/cognitive-services/Bing-News-Search/php.md b/articles/cognitive-services/Bing-News-Search/php.md
@@ -31,12 +31,12 @@ For more information, see [Cognitive Services Pricing - Bing Search API](https:/
 
 To run this application, follow these steps:
 
-1. Make sure that secure HTTP support is enabled in your `php.ini` file, as described in the code comment.
+1. Enable secure HTTP support in your `php.ini` file by uncommenting the `;extension=php_openssl.dll` line, as described in the code comment.
 2. Create a new PHP project in your favorite IDE or editor.
 3. Add the code provided below.
 4. Replace the `accessKey` value with an access key valid for your subscription.
 5. 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.
-5. Run the program.
+6. Run the program.
 
 ```php
 <?php
diff --git a/articles/cognitive-services/Bing-News-Search/ruby.md b/articles/cognitive-services/Bing-News-Search/ruby.md
@@ -18,7 +18,9 @@ ms.custom: seodec2018
 
 Use this quickstart to make your first call to the Bing News Search API. This simple Ruby application sends a search query to the API and processes the JSON response.
 
-Although this application is written in Ruby, 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/ruby/Search/BingNewsSearchv7.rb).
+Although this application is written in Ruby, 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/ruby/Search/BingNewsSearchv7.rb).
 
 ## Prerequisites
 
@@ -47,7 +49,7 @@ Although this application is written in Ruby, the API is a RESTful Web service c
 
 ## Format and make an API request
 
-Use the variables from the last step to format a search URL for the API request. Then, send the request.
+Use the variables from the previous step to format a search URL for the API request. Then, send the request.
 
 ```ruby
 uri = URI(uri + path + "?q=" + URI.escape(term))
@@ -60,7 +62,7 @@ end
 
 ## Process and print the JSON response
 
-After the response is received, you can parse the JSON, and print both the response body, and its headers.
+After the response is received, parse the JSON, and then print both the response body and its headers.
 
 ```ruby
 puts "\nRelevant Headers:\n\n"
