Edits

Author: dksimpson

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

@@ -46,17 +46,18 @@ Although this application is written in C#, the API is a RESTful Web service com
     const string uriBase = "https://api.cognitive.microsoft.com/bing/v7.0/news/search";
     const string searchTerm = "Microsoft";
     ```
-   ## Create a struct to format the Bing News Search response
+   
+## 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.
+Define a `SearchResult` struct to contain the image search results and JSON header information.
 
-    ```csharp
-    struct SearchResult
-    {
-        public String jsonResult;
-        public Dictionary<String, String> relevantHeaders;
-    }
-    ```
+```csharp
+struct SearchResult
+{
+    public String jsonResult;
+    public Dictionary<String, String> relevantHeaders;
+}
+```
 
 ## Create and handle a news search request
 
@@ -101,7 +102,7 @@ Create a method named `BingNewsSearch` to perform the call to the API, and set t
 
 ## Process 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.
+In the main method, call `BingNewsSearch()` and store the returned response. Then, deserialize the JSON into an object where you can view the values of the response.
 
     ```csharp
     SearchResult result = BingNewsSearch(searchTerm);

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

@@ -24,8 +24,8 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
 
 ## Prerequisites
 
-* The [Java Development Kit (JDK) 7 or 8](https://aka.ms/azure-jdks)
-* The [Gson library](https://github.com/google/gson)
+* 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)]

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

@@ -47,7 +47,7 @@ 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. 
+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.  
 

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

@@ -31,7 +31,7 @@ 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. Make sure that secure HTTP support is enabled in your `php.ini` file, 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.

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

@@ -16,7 +16,7 @@ ms.custom: seodec2018
 
 # Quickstart: Perform a news search using Python and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing News Search API. This simple JavaScript application sends a search query to the API and processes the JSON result. 
+Use this quickstart to make your first call to the Bing News Search API. This simple Python application sends a search query to the API and processes the JSON result. 
 
 Although this application is written in Python, the API is a RESTful Web service compatible with most programming languages.
 
@@ -26,8 +26,6 @@ To run this code sample as a Jupyter notebook on [MyBinder](https://mybinder.org
 
 The source code for this sample is also available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/python/Search/BingNewsSearchv7.py).
 
-## Prerequisites
-
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create and initialize the application
@@ -42,7 +40,7 @@ search_term = "Microsoft"
 search_url = "https://api.cognitive.microsoft.com/bing/v7.0/news/search"
 ```
 
-### Create parameters for the request
+## Create parameters for the request
 
 Add your subscription key to a new dictionary, using `"Ocp-Apim-Subscription-Key"` as the key. Do the same for your search parameters.
 
@@ -67,7 +65,7 @@ params  = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}
     descriptions = [article["description"] for article in search_results["value"]]
     ```
 
-## Displaying the results
+## Display the results
 
 These descriptions can then be rendered as a table with the search keyword highlighted in **bold**.
 

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

@@ -16,9 +16,9 @@ ms.custom: seodec2018
 
 # Quickstart: Perform a news search using Ruby and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing News Search API. This simple JavaScript application sends a search query to the API and processes the JSON response.
+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.
 
-While this application is written in Python, the API is a RESTful Web service compatible 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
 
@@ -28,7 +28,7 @@ While this application is written in Python, the API is a RESTful Web service co
 
 ## Create and initialize the application
 
-1. import the following packages into your code file:
+1. Import the following packages into your code file:
 
     ```ruby
     require 'net/https'
@@ -60,7 +60,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, you can parse the JSON, and print both the response body, and its headers.
 
 ```ruby
 puts "\nRelevant Headers:\n\n"
@@ -173,4 +173,4 @@ A successful response is returned in JSON, as shown in the following example:
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Create a signle-page app](tutorial-bing-news-search-single-page-app.md)
+> [Create a single-page web app](tutorial-bing-news-search-single-page-app.md)

includes/cognitive-services-bing-news-search-signup-requirements.md

@@ -10,14 +10,14 @@ ms.date: 05/19/2020
 
 Start using the Bing News Search API by creating one of the following Azure resources:
 
-* [Trial resource](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api)
-    * No Azure subscription is needed.
-    * Valid for seven days, for free. After you sign up, a trial key and endpoint are available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).
+[Trial resource](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api)
+   * No Azure subscription is needed.
+   * Valid for seven days, for free. After you sign up, a trial key and endpoint are available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).
 
-* [Bing Search v7 resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingSearch-v7)
-    * Available through the Azure portal until you delete the resource.
-    * Use the free pricing tier to try the service, and upgrade later to a paid tier for production.
+[Bing Search v7 resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingSearch-v7)
+   * Available through the Azure portal until you delete the resource.
+   * Use the free pricing tier to try the service, and upgrade later to a paid tier for production.
 
-* [Multi-service resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne)
-    * Available through the Azure portal until you delete the resource.  
-    * Use the same key and endpoint for your applications, across multiple Cognitive Services.
+[Multi-service resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne)
+   * Available through the Azure portal until you delete the resource.  
+   * Use the same key and endpoint for your applications, across multiple Cognitive Services.