Edits

Author: dksimpson

articles/cognitive-services/bing-visual-search/quickstarts/csharp.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 05/21/2020
+ms.date: 05/22/2020
 ms.author: scottwhi
 ---
 
@@ -37,15 +37,15 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
     using System.Collections.Generic;
     ```
 
-2. Add variables for your subscription key, endpoint, and path to the image you want to upload. For the `uriBase` value, 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:
+2. Add variables for your subscription key, endpoint, and path to the image you want to upload. For the `uriBase` value, 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 = "<my_subscription_key>";
         const string uriBase = "https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch";
         static string imagePath = @"<path_to_image>";
     ```
 
-3. Create a method named `GetImageFileName()` to get the path for your image:
+3. Create a method named `GetImageFileName()` to get the path for your image.
 
     ```csharp
     static string GetImageFileName(string path)
@@ -54,7 +54,7 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
             }
     ```
 
-4. Create a method to get the binary data of the image:
+4. Create a method to get the binary data of the image.
 
     ```csharp
     static byte[] GetImageBinary(string path)
@@ -65,7 +65,7 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
 
 ## Build the form data
 
-1. To upload a local image, first build the form data to send to the API. The form data includes the `Content-Disposition` header, the `name` parameter set to "image", and the `filename` parameter set to any string. The contents of the form contain the binary data of the image. The maximum image size you can upload is 1 MB.
+1. To upload a local image, first build the form data to send to the API. The form data includes the `Content-Disposition` header, the `name` parameter set to "image", and the `filename` parameter set to the file name of the image. The contents of the form contain the binary data of the image. The maximum image size you can upload is 1 MB.
 
     ```
     --boundary_1234-abcd
@@ -76,7 +76,7 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
     --boundary_1234-abcd--
     ```
 
-2. Add boundary strings to format the POST form data. Boundary strings determine the start, end, and newline characters for the data:
+2. Add boundary strings to format the POST form data. Boundary strings determine the start, end, and newline characters for the data.
 
     ```csharp
     // Boundary strings for form data in body of POST.
@@ -93,7 +93,7 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
     const string POST_BODY_DISPOSITION_HEADER = "Content-Disposition: form-data; name=\"image\"; filename=\"{0}\"" + CRLF +CRLF;
     ```
 
-4. Create a function named `BuildFormDataStart()` to create the start of the form data using the boundary strings and image path:
+4. Create a function named `BuildFormDataStart()` to create the start of the form data by using the boundary strings and image path.
 
     ```csharp
         static string BuildFormDataStart(string boundary, string filename)
@@ -107,7 +107,7 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
         }
     ```
 
-5. Create a function named `BuildFormDataEnd()` to create the end of the form data using the boundary strings:
+5. Create a function named `BuildFormDataEnd()` to create the end of the form data by using the boundary strings.
 
     ```csharp
         static string BuildFormDataEnd(string boundary)
@@ -154,14 +154,14 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
 
 ## Create the Main method
 
-1. In the `Main()` method of your application, get the filename and binary data of your image:
+1. In the `Main()` method of your application, get the filename and binary data of your image.
 
     ```csharp
     var filename = GetImageFileName(imagePath);
     var imageBinary = GetImageBinary(imagePath);
     ```
 
-2. Set up the POST body by formatting the boundary for it. Then, call `startFormData()` and `endFormData` to create the form data:
+2. Set up the POST body by formatting its boundary. Then, call `BuildFormDataStart()` and `BuildFormDataEnd()` to create the form data.
 
     ```csharp
     // Set up POST body.
@@ -170,13 +170,13 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
     var endFormData = BuildFormDataEnd(boundary);
     ```
 
-3. Create the `ContentType` value by formatting `CONTENT_TYPE_HEADER_PARAMS` and the form data boundary:
+3. Create the `ContentType` value by formatting `CONTENT_TYPE_HEADER_PARAMS` and the form data boundary.
 
     ```csharp
     var contentTypeHdrValue = string.Format(CONTENT_TYPE_HEADER_PARAMS, boundary);
     ```
 
-4. Get the API response by calling `BingImageSearch()`, and then print the response:
+4. Get the API response by calling `BingImageSearch()`, and then print the response.
 
     ```csharp
     var json = BingImageSearch(startFormData, endFormData, imageBinary, contentTypeHdrValue);
@@ -187,7 +187,7 @@ This quickstart demonstrates how to upload an image to the Bing Visual Search AP
 
 ## Using HttpClient
 
-If you use `HttpClient`, you can use the `MultipartFormDataContent` class to build the form data. Use the following sections of code to replace the corresponding methods in the previous example.
+If you use `HttpClient`, you can use the `MultipartFormDataContent` class to build the form data. Use the following sections of code to replace the corresponding methods in the previous example:
 
 1. Replace the `Main()` method with the following code:
 

articles/cognitive-services/bing-visual-search/quickstarts/go.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 05/21/2020
+ms.date: 05/22/2020
 ms.author: aahi
 ---
 
@@ -232,7 +232,7 @@ resp, err := client.Do(req)
 
 ## Handle the response
 
-The `Unmarshall` function extracts information from the JSON text returned by the Visual Search API. The `go-spew` pretty printer displays the results:
+The `Unmarshall` function extracts information from the JSON text returned by the Visual Search API. The `go-spew` pretty printer displays the results.
 
 ```go
 	// Create a new answer.  
@@ -255,7 +255,7 @@ The `Unmarshall` function extracts information from the JSON text returned by th
 
 ## Results
 
-The results identify images similar to the image contained in the POST body. The useful fields are `WebSearchUrl` and `Name`:
+The results identify images similar to the image contained in the POST body. The useful fields are `WebSearchUrl` and `Name`.
 
 ```go
     Value: ([]struct { WebSearchUrl string "json:\"webSearchUrl\""; Name string "json:\"name\"" }) (len=66 cap=94) {

articles/cognitive-services/bing-visual-search/quickstarts/java.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 05/21/2020
+ms.date: 05/22/2020
 ms.author: scottwhi
 ---
 
@@ -48,7 +48,7 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
     import org.apache.http.impl.client.HttpClientBuilder;
     ```
 
-2. Create variables for your API endpoint, subscription key, and the path to your image. For the `endpoint` value, 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:
+2. Create variables for your API endpoint, subscription key, and the path to your image. For the `endpoint` value, 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 endpoint = "https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch";
@@ -57,7 +57,7 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
     ```
 
 
-3. When you upload a local image, the form data must include the `Content-Disposition` header. Set its `name` parameter to "image", and set the `filename` parameter to any string. The contents of the form include the binary data of the image. The maximum image size you can upload is 1 MB.
+3. When you upload a local image, the form data must include the `Content-Disposition` header. Set its `name` parameter to "image", and set the `filename` parameter to the file name of the image. The contents of the form include the binary data of the image. The maximum image size you can upload is 1 MB.
 
     ```
     --boundary_1234-abcd
@@ -70,7 +70,7 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
 
 ## Create the JSON parser
 
-Create a method to make the JSON response from the API more readable by using `JsonParser`:
+Create a method to make the JSON response from the API more readable by using `JsonParser`.
 
 ```java
 public static String prettify(String json_text) {
@@ -83,13 +83,13 @@ public static String prettify(String json_text) {
 
 ## Construct the search request and query
 
-1. In the main method of your application, create an HTTP client using `HttpClientBuilder.create().build();`:
+1. In the main method of your application, create an HTTP client using `HttpClientBuilder.create().build();`.
 
     ```java
     CloseableHttpClient httpClient = HttpClientBuilder.create().build();
     ```
 
-2. Create an `HttpEntity` object to upload your image to the API:
+2. Create an `HttpEntity` object to upload your image to the API.
 
     ```java
     HttpEntity entity = MultipartEntityBuilder
@@ -98,7 +98,7 @@ public static String prettify(String json_text) {
         .build();
     ```
 
-3. Create an `httpPost` object with your endpoint, and set the header to use your subscription key:
+3. Create an `httpPost` object with your endpoint, and set the header to use your subscription key.
 
     ```java
     HttpPost httpPost = new HttpPost(endpoint);
@@ -108,14 +108,14 @@ public static String prettify(String json_text) {
 
 ## Receive and process the JSON response
 
-1. Use the `HttpClient.execute()` method to send a request to the API, and store the response in an `InputStream` object:
+1. Use the `HttpClient.execute()` method to send a request to the API, and store the response in an `InputStream` object.
     
     ```java
     HttpResponse response = httpClient.execute(httpPost);
     InputStream stream = response.getEntity().getContent();
     ```
 
-2. Store the JSON string, and print the response:
+2. Store the JSON string, and print the response.
 
     ```java
     String json = new Scanner(stream).useDelimiter("\\A").next();

articles/cognitive-services/bing-visual-search/quickstarts/nodejs.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 05/21/2020
+ms.date: 05/22/2020
 ms.author: scottwhi
 ---
 
@@ -35,15 +35,15 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
     var fs = require('fs');
     ```
 
-2. Create variables for your API endpoint, subscription key, and the path to your image. For the `baseUri` value, 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:
+2. Create variables for your API endpoint, subscription key, and the path to your image. For the `baseUri` value, 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
     var baseUri = 'https://api.cognitive.microsoft.com/bing/v7.0/images/visualsearch';
     var subscriptionKey = 'your-api-key';
     var imagePath = "path-to-your-image";
     ```
 
-3. Create a function named `requestCallback()` to print the response from the API:
+3. Create a function named `requestCallback()` to print the response from the API.
 
     ```javascript
     function requestCallback(err, res, body) {
@@ -53,7 +53,7 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
 
 ## Construct and send the search request
 
-1. When you upload a local image, the form data must include the `Content-Disposition` header. Set its `name` parameter to "image", and set the `filename` parameter to any string. The contents of the form include the binary data of the image. The maximum image size you can upload is 1 MB.
+1. When you upload a local image, the form data must include the `Content-Disposition` header. Set its `name` parameter to "image", and set the `filename` parameter to the file name of your image. The contents of the form include the binary data of the image. The maximum image size you can upload is 1 MB.
 
    ```
    --boundary_1234-abcd
@@ -64,14 +64,14 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
    --boundary_1234-abcd--
    ```
 
-2. Create a new `FormData` object with `FormData()`, and append your image path to it by using `fs.createReadStream()`:
+2. Create a new `FormData` object with `FormData()`, and append your image path to it by using `fs.createReadStream()`.
     
     ```javascript
     var form = new FormData();
     form.append("image", fs.createReadStream(imagePath));
     ```
 
-3. Use the request library to upload the image, and call `requestCallback()` to print the response. Add your subscription key to the request header:
+3. Use the request library to upload the image, and call `requestCallback()` to print the response. Add your subscription key to the request header.
 
     ```javascript
     form.getLength(function(err, length){

articles/cognitive-services/bing-visual-search/quickstarts/python.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 05/21/2020
+ms.date: 05/22/2020
 ms.author: scottwhi
 ---
 
@@ -40,7 +40,7 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
     imagePath = 'your-image-path'
     ```
 
-3. When you upload a local image, the form data must include the `Content-Disposition` header. Set its `name` parameter to "image", and set the `filename` parameter to any string. The contents of the form include the binary data of the image. The maximum image size you can upload is 1 MB.
+3. When you upload a local image, the form data must include the `Content-Disposition` header. Set its `name` parameter to "image", and set the `filename` parameter to the file name of your image. The contents of the form include the binary data of the image. The maximum image size you can upload is 1 MB.
 
     ```
     --boundary_1234-abcd
@@ -51,21 +51,21 @@ Use this quickstart to make your first call to the Bing Visual Search API. This
     --boundary_1234-abcd--
     ```
 
-4. Create a dictionary object to hold your request's header information. Bind your subscription key to the string `Ocp-Apim-Subscription-Key`:
+4. Create a dictionary object to hold your request's header information. Bind your subscription key to the string `Ocp-Apim-Subscription-Key`.
 
     ```python
     HEADERS = {'Ocp-Apim-Subscription-Key': SUBSCRIPTION_KEY}
     ```
 
-5. Create another dictionary to contain your image, which is opened and uploaded when you send the request:
+5. Create another dictionary to contain your image, which is opened and uploaded when you send the request.
 
     ```python
     file = {'image' : ('myfile', open(imagePath, 'rb'))}
     ```
 
 ## Parse the JSON response
 
-Create a method called `print_json()` to accept the API response, and print the JSON:
+Create a method called `print_json()` to accept the API response, and print the JSON.
 
 ```python
 def print_json(obj):
@@ -75,7 +75,7 @@ def print_json(obj):
 
 ## Send the request
 
-Use `requests.post()` to send a request to the Bing Visual Search API. Include the string for your endpoint, header, and file information. Print `response.json()` with `print_json()`:
+Use `requests.post()` to send a request to the Bing Visual Search API. Include the string for your endpoint, header, and file information. Print `response.json()` with `print_json()`.
 
 ```python
 try: