Merge pull request #115180 from dksimpson/DKS-US1712683-bing-spell-check

Refresh Bing Spell Check REST API quickstarts

Author: GitHubber17

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

@@ -8,28 +8,34 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-spell-check
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/21/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.
-* If you're using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
+* 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, you can run this application by 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 +47,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 +63,19 @@ 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/region 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 string for your search parameters: 
+
+   a. Assign your market code to the `mkt` parameter with the `=` operator. The market code is the code of the country/region you make the request from. 
+
+   b. Add the `mode` parameter with the `&` operator, and then assign the spell-check mode. The mode can be 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 +132,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 +194,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/21/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,11 @@ 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 this function, add the code specified in the next steps. Create a string for the request parameters:
+
+   a. Assign your market code to the `mkt` parameter with the `=` operator. 
+
+   b. Add the `mode` parameter with the `&` operator, and then assign the spell-check mode. 
 
    ```java
    public static void check () throws Exception {
@@ -60,14 +66,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 +82,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 +93,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, which formats the JSON for a more readable output.
 
     ``` java
     // This function prettifies the json response.
@@ -113,7 +119,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 {
@@ -127,19 +133,19 @@ In the main function of your application, call your check() method created above
 
 ## Run the application
 
-Build and run your project.
+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.
+1. Build the application:
 
-**Build:**
-```bash
-javac -classpath .;gson-2.2.2.jar\* <CLASS_NAME>.java
-```
+   ```bash
+   javac -classpath .;gson-2.2.2.jar\* <CLASS_NAME>.java
+   ```
 
-**Run:**
-```bash
-java -cp .;gson-2.2.2.jar\* <CLASS_NAME>
-```
+2. Run the application:
+
+   ```bash
+   java -cp .;gson-2.2.2.jar\* <CLASS_NAME>
+   ```
 
 ## Example JSON response
 
@@ -189,4 +195,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/21/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,11 @@ 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/region 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: 
+
+   a. Assign your market code to the `mkt` parameter with the `=` operator. The market code is the code of the country/region you make the request from. 
+
+   b. Add the `mode` parameter with the `&` operator, and then assign the spell-check mode. The mode can be 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 +54,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.
+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 = {
@@ -65,7 +71,7 @@ let request_params = {
 
 ## Create a response handler
 
-Create a function called `response_handler` to take the JSON response from the API, and print it. Create a variable for the response body. Append the response when a `data` flag is received, using `response.on()`. When a `end` flag is received, print the JSON body to the console.
+Create a function called `response_handler` to take the JSON response from the API, and print it. Create a variable for the response body. Append the response when a `data` flag is received by using `response.on()`. After an `end` flag is received, print the JSON body to the console.
 
 ```javascript
 let response_handler = function (response) {
@@ -85,7 +91,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 then  end the request.
 
 ```javascript
 let req = https.request (request_params, response_handler);
@@ -96,13 +102,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 command to build and run the application:
 
-```bash
-node <FILE_NAME>.js
-```
+   ```bash
+   node <FILE_NAME>.js
+   ```
 
 
 ## Example JSON response
@@ -150,7 +156,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)
+- [Bing Spell Check API v7 reference](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-spell-check-api-v7-reference)