Refresh Bing Spell Check REST API quickstarts

Author: dksimpson

articles/cognitive-services/Bing-Spell-Check/quickstarts/csharp.md

@@ -8,28 +8,31 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-spell-check
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ---
 
 # Quickstart: Check spelling with the Bing Spell Check REST API and C#
 
-Use this quickstart to make your first call to the Bing Spell Check REST API. This simple C# application sends a request to the API and returns a list of suggested corrections. While this application is written in C#, the API is a RESTful Web service compatible with most programming languages. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingAutosuggestv7.cs).
+Use this quickstart to make your first call to the Bing Spell Check REST API. This simple C# application sends a request to the API and returns a list of suggested corrections. 
+
+Although this application is written in C#, the API is a RESTful Web service compatible with most programming languages. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingAutosuggestv7.cs).
 
 ## Prerequisites
 
 * Any edition of [Visual Studio 2017 or later](https://www.visualstudio.com/downloads/).
-* To install `Newtonsoft.Json` as a NuGet package in Visual studio:
-    1. In **Solution Explorer**, right-click the Solution file.
-    1. Select **Manage NuGet Packages for Solution**.
-    1. Search for `Newtonsoft.Json` and install the package.
+* The Newtonsoft.Json NuGet package. 
+     To install this package in Visual studio:
+     1. In **Solution Explorer**, right-click the Solution file.
+     1. Select **Manage NuGet Packages for Solution**.
+     1. Search for *Newtonsoft.Json* and install the package.
 * If you're using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
 
 [!INCLUDE [cognitive-services-bing-spell-check-signup-requirements](../../../../includes/cognitive-services-bing-spell-check-signup-requirements.md)]
 
 ## Create and initialize a project
 
-1. Create a new console solution named `SpellCheckSample` in Visual Studio. Then add the following namespaces into the main code file.
+1. Create a new console solution named SpellCheckSample in Visual Studio. Then, add the following namespaces into the main code file:
 
     ```csharp
     using System;
@@ -41,7 +44,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
     using Newtonsoft.Json;
     ```
 
-2. Create variables for the API endpoint, your subscription key, and the text to be spell checked. 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 the text to be spell checked. 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
     namespace SpellCheckSample
@@ -57,15 +60,15 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
     }
     ```
 
-3. Create a variable for your search parameters. Append your market code after `mkt=`. The market code is the country you make the request from. Also, append your spell-check mode after `&mode=`. Mode is either `proof` (catches most spelling/grammar errors) or `spell` (catches most spelling but not as many grammar errors).
+3. Create a variable for your search parameters. Append your market code to the `mkt=` parameter. The market code is the code of the country you make the request from. Append your spell-check mode to the `&mode=` parameter. The mode is either `proof` (catches most spelling/grammar errors) or `spell` (catches most spelling errors, but not as many grammar errors).
 
     ```csharp
     static string params_ = "mkt=en-US&mode=proof";
     ```
 
 ## Create and send a spell check request
 
-1. Create an asynchronous function called `SpellCheck()` to send a request to the API. Create a `HttpClient`, and add your subscription key to the `Ocp-Apim-Subscription-Key` header. Then perform the following steps within the function.
+1. Create an asynchronous function called `SpellCheck()` to send a request to the API. Create a `HttpClient`, and add your subscription key to the `Ocp-Apim-Subscription-Key` header. Within the function, follow the next steps.
 
     ```csharp
     async static void SpellCheck()
@@ -122,7 +125,7 @@ Console.WriteLine(jsonObj);
 
 ## Call the spell check function
 
-In the Main function of your project, call `SpellCheck()`.
+In the `Main()` function of your project, call `SpellCheck()`.
 
 ```csharp
 static void Main(string[] args)
@@ -184,4 +187,4 @@ A successful response is returned in JSON, as shown in the following example:
 > [Create a single-page web app](../tutorials/spellcheck.md)
 
 - [What is the Bing Spell Check API?](../overview.md)
-- [Bing Spell Check API v7 Reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)
+- [Bing Spell Check API v7 reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)

articles/cognitive-services/Bing-Spell-Check/quickstarts/java.md

@@ -9,25 +9,27 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-spell-check
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ---
 
 # Quickstart: Check spelling with the Bing Spell Check REST API and Java
 
-Use this quickstart to make your first call to the Bing Spell Check REST API. This simple Java application sends a request to the API and returns a list of suggested corrections. While this application is written in Java, the API is a RESTful web service compatible with most programming languages. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingSpellCheck.java).
+Use this quickstart to make your first call to the Bing Spell Check REST API. This simple Java application sends a request to the API and returns a list of suggested corrections. 
+
+Although this application is written in Java, the API is a RESTful web service compatible with most programming languages. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingSpellCheck.java).
 
 ## Prerequisites
 
 * The Java Development Kit(JDK) 7 or later.
 
-* Import the [gson-2.8.5.jar](https://libraries.io/maven/com.google.code.gson%3Agson) or the most current [Gson](https://github.com/google/gson) version. For command line execution, add the `.jar` to your Java folder with the main class.
+* Import the [gson-2.8.5.jar](https://libraries.io/maven/com.google.code.gson%3Agson) or the most current [Gson](https://github.com/google/gson) version. For command-line execution, add the `.jar` to your Java folder with the main class.
 
 [!INCLUDE [cognitive-services-bing-spell-check-signup-requirements](../../../../includes/cognitive-services-bing-spell-check-signup-requirements.md)]
 
 ## Create and initialize an application
 
-1. Create a new Java Project in your favorite IDE or editor with a class name of your choosing, and then import the following packages.
+1. Create a new Java Project in your favorite IDE or editor with a class name of your choosing, and then import the following packages:
 
     ```java
     import java.io.*;
@@ -36,7 +38,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
     import javax.net.ssl.HttpsURLConnection;
     ```
 
-2. Create variables for the API endpoint's host, path, and your subscription key. Then create variables for your market, the text you want to spell check, and a string for the spell check mode. 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's host, path, and your subscription key. Then, create variables for your market, the text you want to spell check, and a string for the spell check mode. 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
     static String host = "https://api.cognitive.microsoft.com";
@@ -51,7 +53,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 
 ## Create and send an API request
 
-1. Create a function called `check()` to create and send the API request. Within it, follow these steps. Create a string for the request parameters. append the `?mkt=` parameter to your market string, and the `&mode=` parameter to your spell check mode.  
+1. Create a function called `check()` to create and send the API request. Within it, follow the next steps. Create a string for the request parameters. Append your market string to the `?mkt=` parameter, and the spell-check mode to the `&mode=` parameter.  
 
    ```java
    public static void check () throws Exception {
@@ -60,14 +62,14 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
    }
    ```
 
-2. Create a URL by combining the endpoint host, path and parameters string. Create a new `HttpsURLConnection` object.
+2. Create a URL by combining the endpoint host, path, and parameters string. Create a new `HttpsURLConnection` object.
 
     ```java
     URL url = new URL(host + path + params);
     HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
     ```
 
-3. Open a connection to the URL. Set the request method to `POST`. Add your request parameters. Make sure to add your subscription key to the `Ocp-Apim-Subscription-Key` header.
+3. Open a connection to the URL. Set the request method to `POST` and add your request parameters. Be sure to add your subscription key to the `Ocp-Apim-Subscription-Key` header.
 
     ```java
 	connection.setRequestMethod("POST");
@@ -76,7 +78,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 	connection.setDoOutput(true);
     ```
 
-4. Create a new `DataOutputStream` object and Send the request to the API.
+4. Create a new `DataOutputStream` object and send the request to the API.
 
     ```java
         DataOutputStream wr = new DataOutputStream(connection.getOutputStream());
@@ -87,7 +89,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 
 ## Format and read the API response
 
-1. Add this method to your class. It formats the JSON for a more readable output.
+1. Add the `prettify()` method to your class. It formats the JSON for a more readable output.
 
     ``` java
     // This function prettifies the json response.
@@ -113,7 +115,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 
 ## Call the API
 
-In the main function of your application, call your check() method created above.
+In the main function of your application, call your check() method created previously.
 ```java
     	public static void main(String[] args) {
     		try {
@@ -129,7 +131,7 @@ In the main function of your application, call your check() method created above
 
 Build and run your project.
 
-If you're using the command line, use the following commands to build and run the application.
+If you're using the command line, use the following commands to build and run the application:
 
 **Build:**
 ```bash
@@ -189,4 +191,4 @@ A successful response is returned in JSON, as shown in the following example:
 > [Create a single-page web app](../tutorials/spellcheck.md)
 
 - [What is the Bing Spell Check API?](../overview.md)
-- [Bing Spell Check API v7 Reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)
+- [Bing Spell Check API v7 reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)

articles/cognitive-services/Bing-Spell-Check/quickstarts/nodejs.md

@@ -9,13 +9,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-spell-check
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ---
 
 # Quickstart: Check spelling with the Bing Spell Check REST API and Node.js
 
-Use this quickstart to make your first call to the Bing Spell Check REST API. This simple Node application sends a request to the API and returns a list of words it didn't recognize, followed by suggested corrections. While this application is written in Node.js, the API is a RESTful Web service compatible with most programming languages. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/nodejs/Search/BingSpellCheckv7.js).
+Use this quickstart to make your first call to the Bing Spell Check REST API. This simple JavaScript application sends a request to the API and returns a list of suggested corrections. 
+
+Although this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/nodejs/Search/BingSpellCheckv7.js).
 
 ## Prerequisites
 
@@ -26,7 +28,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 
 ## Create and initialize a project
 
-1. Create a new JavaScript file in your favorite IDE or editor. Set the strictness, and require `https`. Then create variables for your API endpoint's host, path, and your subscription key. 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.
+1. Create a new JavaScript file in your favorite IDE or editor. Set the strictness, and require `https`. Then, create variables for your API endpoint's host, path, and your subscription key. 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
     'use strict';
@@ -37,7 +39,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
     let key = '<ENTER-KEY-HERE>';
     ```
 
-2. Create variables for your search parameters and the text you want to check. Append your market code after `mkt=`. The market code is the country you make the request from. Also, append your spell-check mode after `&mode=`. Mode is either `proof` (catches most spelling/grammar errors) or `spell` (catches most spelling but not as many grammar errors).
+2. Create variables for your search parameters and the text you want to check. Append your market code to the `mkt=` parameter. The market code is code for the country you make the request from. Append your spell-check mode to the `&mode=` parameter. The mode is either `proof` (catches most spelling/grammar errors) or `spell` (catches most spelling errors but not as many grammar errors).
 
     ```javascript
     let mkt = "en-US";
@@ -48,7 +50,7 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 
 ## Create the request parameters
 
-Create your request parameters by creating a new object with a `POST` method. Add your path by appending your endpoint path, and query string. Add your subscription key to the `Ocp-Apim-Subscription-Key` header.
+1. Create your request parameters by creating a new object with a `POST` method. Add your path by appending your endpoint path, and query string. Then, add your subscription key to the `Ocp-Apim-Subscription-Key` header.
 
 ```javascript
 let request_params = {
@@ -85,7 +87,7 @@ let response_handler = function (response) {
 
 ## Send the request
 
-Call the API using `https.request()` with your request parameters, and response handler. Write your text to the API, and end the request afterwards.
+Call the API using `https.request()` with your request parameters and response handler. Write your text to the API, and end the request afterwards.
 
 ```javascript
 let req = https.request (request_params, response_handler);
@@ -96,13 +98,13 @@ req.end ();
 
 ## Run the application
 
-Build and run your project.
+1. Build and run your project.
 
-If you're using the command line, use the following commands to build and run the application.
+1. If you're using the command line, use the following commands to build and run the application:
 
-```bash
-node <FILE_NAME>.js
-```
+   ```bash
+   node <FILE_NAME>.js
+   ```
 
 
 ## Example JSON response
@@ -150,7 +152,7 @@ A successful response is returned in JSON, as shown in the following example:
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Create a single page web-app](../tutorials/spellcheck.md)
+> [Create a single-page web app](../tutorials/spellcheck.md)
 
 - [What is the Bing Spell Check API?](../overview.md)
 - [Bing Spell Check API v7 Reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)

articles/cognitive-services/Bing-Spell-Check/quickstarts/php.md

@@ -9,12 +9,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-spell-check
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/19/2020
 ms.author: aahi
 ---
 # Quickstart: Check spelling with the Bing Spell Check REST API and PHP
 
-Use this quickstart to make your first call to the Bing Spell Check REST API. This simple PHP application sends a request to the API and returns a list of suggested corrections. While this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.
+Use this quickstart to make your first call to the Bing Spell Check REST API. This simple PHP application sends a request to the API and returns a list of suggested corrections. 
+
+Although this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -23,12 +25,12 @@ Use this quickstart to make your first call to the Bing Spell Check REST API. Th
 [!INCLUDE [cognitive-services-bing-spell-check-signup-requirements](../../../../includes/cognitive-services-bing-spell-check-signup-requirements.md)]
 
 
-## Get Spell Check results
+## Get Bing Spell Check REST API results
 
 1. Create a new PHP project in your favorite IDE.
 2. Add the code provided below.
 3. Replace the `subscriptionKey` value with an access key valid for your subscription.
-4. 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.
+4. 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.
 
     ```php
@@ -135,7 +137,7 @@ A successful response is returned in JSON, as shown in the following example:
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Create a single page web-app](../tutorials/spellcheck.md)
+> [Create a single-page web app](../tutorials/spellcheck.md)
 
 - [What is the Bing Spell Check API?](../overview.md)
 - [Bing Spell Check API v7 Reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)