Edit Go client library quickstart

Author: dksimpson

articles/cognitive-services/Bing-Autosuggest/includes/quickstarts/autosuggest-client-library-csharp.md

@@ -18,12 +18,12 @@ Use the Bing Autosuggest client library for .NET to get search suggestions based
 
 ## Prerequisites
 
-* An Azure subscription. If you don't already have an Azure subscription, [create one for free](https://azure.microsoft.com/free/).
+* An Azure subscription. If you don't already have an Azure subscription, [you can create one for free](https://azure.microsoft.com/free/).
 * The current version of [.NET Core](https://dotnet.microsoft.com/download/dotnet-core).
 
 [!INCLUDE [cognitive-services-bing-autosuggest-signup-requirements](~/includes/cognitive-services-bing-autosuggest-signup-requirements.md)]
 
-## Create an environment variable
+## Create environment variables
 
 >[!NOTE]
 > The endpoints for non-trial resources created after July 1, 2019 use the custom subdomain format shown below. For more information and a complete list of regional endpoints, see [Custom subdomain names for Cognitive Services](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains). 
@@ -138,7 +138,7 @@ If you're using the Visual Studio IDE, the client library is available as a down
 These code snippets show you how to do the following tasks with the Bing Autosuggest client library for .NET:
 
 * [Authenticate the client](#authenticate-the-client)
-* [Send an autosuggest request](#send-an-autosuggest-request)
+* [Send an Autosuggest request](#send-an-autosuggest-request)
 
 ### Authenticate the client
 

articles/cognitive-services/Bing-Autosuggest/includes/quickstarts/autosuggest-client-library-go.md

@@ -6,7 +6,7 @@ author: aahill
 manager: nitinme
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 04/06/2020
+ms.date: 05/06/2020
 ms.author: aahi
 ---
 
@@ -18,31 +18,26 @@ Use the Bing Autosuggest client library for Go to get search suggestions based o
 
 ## Prerequisites
 
-* An Azure subscription - [create one for free](https://azure.microsoft.com/free/)
-* The latest version of [Go](https://golang.org/dl/)
-
-## Setting up
-
-### Create an Azure resource 
+* An Azure subscription. If you don't already have an Azure subscription, [you can create one for free](https://azure.microsoft.com/free/).
+* The latest version of [Go](https://golang.org/dl/).
 
 Begin using the Bing Autosuggest client library by creating an Azure resource. Choose the resource type below that's right for you:
 
 [!INCLUDE [cognitive-services-bing-autosuggest-signup-requirements](~/includes/cognitive-services-bing-autosuggest-signup-requirements.md)]
 
-### Create an environment variable
+## Create environment variables
 
 >[!NOTE]
 > The endpoints for non-trial resources created after July 1, 2019 use the custom subdomain format shown below. For more information and a complete list of regional endpoints, see [Custom subdomain names for Cognitive Services](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains). 
 
 Using your key and endpoint from the resource you created, create two environment variables for authentication:
 <!-- replace the below variable names with the names expected in the code sample.-->
-* `AUTOSUGGEST_SUBSCRIPTION_KEY` - The resource key for authenticating your requests.
-* `AUTOSUGGEST_ENDPOINT` - The resource endpoint for sending API requests. It will look like this: 
-  * `https://<your-custom-subdomain>.api.cognitive.microsoft.com` 
+* `AUTOSUGGEST_SUBSCRIPTION_KEY`: The resource key for authenticating your requests.
+* `AUTOSUGGEST_ENDPOINT`: The resource endpoint for sending API requests. It should look like this: `https://<your-custom-subdomain>.api.cognitive.microsoft.com` 
 
 Use the instructions for your operating system.
 <!-- replace the below endpoint and key examples -->
-#### [Windows](#tab/windows)
+### [Windows](#tab/windows)
 
 ```console
 setx BING_AUTOSUGGEST_SUBSCRIPTION_KEY <replace-with-your-autosuggest-api-key>
@@ -51,7 +46,7 @@ setx BING_AUTOSUGGEST_ENDPOINT <replace-with-your-autosuggest-api-endpoint>
 
 After you add the environment variable, restart the console window.
 
-#### [Linux](#tab/linux)
+### [Linux](#tab/linux)
 
 ```bash
 export AUTOSUGGEST_SUBSCRIPTION_KEY=<replace-with-your-autosuggest-api-key>
@@ -60,7 +55,7 @@ export AUTOSUGGEST_ENDPOINT=<replace-with-your-autosuggest-api-endpoint>
 
 After you add the environment variable, run `source ~/.bashrc` from your console window to make the changes effective.
 
-#### [macOS](#tab/unix)
+### [macOS](#tab/unix)
 
 Edit your `.bash_profile`, and add the environment variable:
 
@@ -72,13 +67,13 @@ export AUTOSUGGEST_ENDPOINT=<replace-with-your-autosuggest-api-endpoint>
 After you add the environment variable, run `source .bash_profile` from your console window to make the changes effective.
 ***
 
-### Create a new Go project
+## Create a new Go project
 
 In a console window (cmd, PowerShell, Terminal, Bash), create a new workspace for your Go project and navigate to it. Your workspace will contain three folders: 
 
-* **src** - This directory contains source code and packages. Any packages installed with the `go get` command will reside here.
-* **pkg** - This directory contains the compiled Go package objects. These files all have an `.a` extension.
-* **bin** - This directory contains the binary executable files that are created when you run `go install`.
+* **src**: This directory contains source code and packages. Any packages installed with the `go get` command will reside here.
+* **pkg**: This directory contains the compiled Go package objects. These files all have an `.a` extension.
+* **bin**: This directory contains the binary executable files that are created when you run `go install`.
 
 > [!TIP]
 > Learn more about the structure of a [Go workspace](https://golang.org/doc/code.html#Workspaces). This guide includes information for setting `$GOPATH` and `$GOROOT`.
@@ -90,7 +85,7 @@ $ mkdir -p my-app/{src, bin, pkg}
 $ cd my-app
 ```
 
-### Install the client library for Go
+## Install the client library for Go
 
 Now, let's install the client library for Go: 
 
@@ -104,7 +99,7 @@ or if you use dep, within your repo run:
 $ dep ensure -add <library-location-or-url>
 ```
 
-### Create your Go application
+## Create your Go application
 
 Next, let's create a file named `src/sample-app.go`:
 
@@ -113,7 +108,7 @@ $ cd src
 $ touch sample-app.go
 ```
 
-Open `sample-app.go` and add the package name and import the following libraries:
+Open `sample-app.go`, add the package name, and then import the following libraries:
 
 ```Go
 package main
@@ -128,7 +123,7 @@ import (
 )
 ```
 
-Create a function named `main`. Then create environment variables for your Bing Autosuggest key and endpoint.
+Create a function named `main`. Then, create environment variables for your Bing Autosuggest key and endpoint:
 
 ```go
 func main() {
@@ -152,7 +147,7 @@ These code samples show you how to complete basic tasks using the Bing Autosugge
 * [Authenticate the client](#authenticate-the-client)
 * [Send an API request](#send-an-api-request)
 
-## Authenticate the client
+### Authenticate the client
 
 > [!NOTE] 
 > This quickstart assumes you've [created an environment variable](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication)  for your Bing autosuggest key, named `BING_AUTOSUGGEST_SUBSCRIPTION_KEY`, and one for your endpoint named `BING_AUTOSUGGEST_ENDPOINT`.
@@ -169,9 +164,9 @@ client.Authorizer = autorest.NewCognitiveServicesAuthorizer(subscription_key)
 client.Endpoint = endpoint
 ```
 
-## Send an API request
+### Send an API request
 
-In the same method, use the client's [AutoSuggestMethodAsync](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.search.autosuggest.autosuggestclientextensions.autosuggestmethodasync?view=azure-dotnet#Microsoft_Azure_CognitiveServices_Search_AutoSuggest_AutoSuggestClientExtensions_AutoSuggestMethodAsync_Microsoft_Azure_CognitiveServices_Search_AutoSuggest_IAutoSuggestClient_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_Collections_Generic_IList_System_String__System_Threading_CancellationToken_) method to send a query to Bing. Then iterate over the [Suggestions](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.search.autosuggest.models.suggestions?view=azure-dotnet) response, and print the first suggestion.
+In the same method, use the client's [AutoSuggestMethodAsync](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.search.autosuggest.autosuggestclientextensions.autosuggestmethodasync?view=azure-dotnet#Microsoft_Azure_CognitiveServices_Search_AutoSuggest_AutoSuggestClientExtensions_AutoSuggestMethodAsync_Microsoft_Azure_CognitiveServices_Search_AutoSuggest_IAutoSuggestClient_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_String_System_Collections_Generic_IList_System_String__System_Threading_CancellationToken_) method to send a query to Bing. Then, iterate over the [Suggestions](https://docs.microsoft.com/dotnet/api/microsoft.azure.cognitiveservices.search.autosuggest.models.suggestions?view=azure-dotnet) response, and print the first suggestion.
 
 ```Go
 // This should return the query suggestion "xbox."
@@ -209,8 +204,8 @@ go run sample-app.go
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
-* [Portal](../../../cognitive-services-apis-create-account.md#clean-up-resources)
-* [Azure CLI](../../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
+* [Delete a resource group in the Azure portal](../../../cognitive-services-apis-create-account.md#clean-up-resources).
+* [Delete a resource group in the Azure CLI](../../../cognitive-services-apis-create-account-cli.md#clean-up-resources).
 
 ## Next steps