Merge pull request #114091 from PatrickFarley/formre-track2-sdk

[cog serv] Formre track2 sdk

Author: megvanhuygen

.openpublishing.redirection.json

@@ -48505,6 +48505,11 @@
       "redirect_url": "/azure/cognitive-services/form-recognizer/quickstarts/python-receipts",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/cognitive-services/form-recognizer/quickstarts/dotnet-sdk.md",
+      "redirect_url": "/azure/cognitive-services/form-recognizer/quickstarts/client-library?pivots=programming-language-csharp",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cognitive-services/Content-Moderator/Review-Tool-User-Guide/Upload-Images.md",
       "redirect_url": "/azure/cognitive-services/content-moderator",

articles/cognitive-services/form-recognizer/includes/create-resource.md

@@ -17,7 +17,7 @@ Go to the Azure portal and <a href="https://ms.portal.azure.com/#create/Microsof
 | **Pricing tier** | The cost of your resource depends on the pricing tier you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/).
 | **Resource group** | The [Azure resource group](https://docs.microsoft.com/azure/cloud-adoption-framework/govern/resource-consistency/resource-access-management#what-is-an-azure-resource-group) that will contain your resource. You can create a new group or add it to a pre-existing group. |
 
-> [!IMPORTANT]
+> [!NOTE]
 > Normally when you create a Cognitive Service resource in the Azure portal, you have the option to create a multi-service subscription key (used across multiple cognitive services) or a single-service subscription key (used only with a specific cognitive service). However, because Form Recognizer is a preview release, it is not included in the multi-service subscription, and you cannot create the single-service subscription unless you use the link provided in the Welcome email.
 
-When your Form Recognizer resource finishes deploying, find and select it from the **All resources** list in the portal. Then select the **Quick start** tab to view your subscription data. Save the values of **Key1** and **Endpoint** to a temporary location. You'll use them in the following steps.
+When your Form Recognizer resource finishes deploying, find and select it from the **All resources** list in the portal. Your key and endpoint will be located on the resource's key and endpoint page, under resource management. Save both of these to a temporary location before going forward.

articles/cognitive-services/form-recognizer/includes/environment-variables.md

@@ -0,0 +1,53 @@
+---
+title: "Environment variables"
+description: set environment variables
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: forms-recognizer
+ms.topic: include
+ms.date: 05/06/2020
+ms.author: pafarley
+---
+
+Using your key and endpoint from the resource you created, create two environment variables for authentication:
+
+* `FORM_RECOGNIZER_KEY` - The resource key for authenticating your requests.
+* `FORM_RECOGNIZER_ENDPOINT` - The resource endpoint for sending API requests. It will look like this: 
+  * `https://<your-custom-subdomain>.api.cognitive.microsoft.com` 
+
+>[!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). 
+
+Use the following instructions to set environment variables on your operating system.
+
+#### [Windows](#tab/windows)
+
+```console
+setx FORM_RECOGNIZER_KEY <replace-with-your-form-recognizer-key>
+setx FORM_RECOGNIZER_ENDPOINT <replace-with-your-form-recognizer-endpoint>
+```
+
+After you add the environment variables, close and reopen the console window.
+
+#### [Linux](#tab/linux)
+
+```bash
+export FORM_RECOGNIZER_KEY=<replace-with-your-product-name-key>
+export FORM_RECOGNIZER_ENDPOINT=<replace-with-your-product-name-endpoint>
+```
+
+After you add the environment variable, run `source ~/.bashrc` from your console window to make the changes effective.
+
+#### [macOS](#tab/unix)
+
+Edit your `.bash_profile`, and add the environment variable:
+
+```bash
+export FORM_RECOGNIZER_KEY=<replace-with-your-product-name-key>
+export FORM_RECOGNIZER_ENDPOINT=<replace-with-your-product-name-endpoint>
+```
+
+After you add the environment variables, run `source .bash_profile` from your console window to make the changes effective.
+***