Merge pull request #100951 from IEvangelist/speechQuickstart1656542

GitHubber17 · web-flow · commit d6c2b6c3d628 · 2020-01-13T13:53:01.000-08:00
[CogSvcs] added specific instructions for replacing values
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/cpp/windows.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/cpp/windows.md
@@ -1,27 +1,20 @@
 ---
-title: "Quickstart: Recognize speech stored in blob storage, C++ - Speech service"
-titleSuffix: Azure Cognitive Services
-description: TBD
-services: cognitive-services
-author: erhopf
-manager: nitinme
+author: IEvangelist
 ms.service: cognitive-services
-ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
-ms.author: erhopf
-zone_pivot_groups: programming-languages-set-two
+ms.date: 01/13/2020
+ms.author: dapine
 ---
 
 ## Prerequisites
 
 Before you get started, make sure to:
 
 > [!div class="checklist"]
-> * [Create an Azure Speech Resource](../../../../get-started.md)
-> * [Upload a source file to an azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
-> * [Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=dotnet)
-> * [Create an empty sample project](../../../../quickstarts/create-project.md?tabs=dotnet)
+> * [Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=linux&pivots=programmming-language-cpp)
+> * [Create an empty sample project](../../../../quickstarts/create-project.md?pivots=programmming-language-cpp)
+> * [Create an Azure Speech resource](../../../../get-started.md)
+> * [Upload a source file to an Azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
 
 ## Open your project in Visual Studio
 
@@ -50,7 +43,8 @@ vcpkg install nlohmann-json
 Let's add some code that works as a skeleton for our project.
 
 [!code-cpp[](~/samples-cognitive-services-speech-sdk/quickstart/cpp/windows/from-blob/helloworld.cpp?range=7-32,187-190,300-309)]
-(You'll need to replace the values of `YourSubscriptionKey`, `YourServiceRegion`, and `YourFileUrl` with your own values.)
+
+[!INCLUDE [placeholder-replacements](../placeholder-replacement.md)]
 
 ## JSON Wrappers
 
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/csharp/dotnet.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/csharp/dotnet.md
@@ -1,27 +1,20 @@
 ---
-title: "Quickstart: Recognize speech stored in blob storage, C# - Speech service"
-titleSuffix: Azure Cognitive Services
-description: TBD
-services: cognitive-services
-author: erhopf
-manager: nitinme
+author: IEvangelist
 ms.service: cognitive-services
-ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
-ms.author: erhopf
-zone_pivot_groups: programming-languages-set-two
+ms.date: 01/13/2020
+ms.author: dapine
 ---
 
 ## Prerequisites
 
 Before you get started, make sure to:
 
 > [!div class="checklist"]
-> * [Create an Azure Speech Resource](../../../../get-started.md)
-> * [Upload a source file to an azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
-> * [Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=dotnet)
-> * [Create an empty sample project](../../../../quickstarts/create-project.md?tabs=dotnet)
+> * [Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=vs&pivots=programmming-language-csharp)
+> * [Create an empty sample project](../../../../quickstarts/create-project.md?pivots=programmming-language-csharp)
+> * [Create an Azure Speech resource](../../../../get-started.md)
+> * [Upload a source file to an Azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
 
 ## Open your project in Visual Studio
 
@@ -30,7 +23,7 @@ The first step is to make sure that you have your project open in Visual Studio.
 1. Launch Visual Studio 2019.
 2. Load your project and open `Program.cs`.
 
-## Add a reference to NewtonSoftJSon
+## Add a reference to Newtonsoft.Json
 
 1. In the Solution Explorer, right-click the **helloworld** project, and then select **Manage NuGet Packages** to show the NuGet Package Manager.
 
@@ -40,7 +33,7 @@ The first step is to make sure that you have your project open in Visual Studio.
 
 1. In the search box, type *newtonsoft.json* and select **Enter**.
 
-1. From the search results, select the **Newtonsoft.Json** package, and then select **Install** to install the latest stable version.
+1. From the search results, select the [**Newtonsoft.Json**](https://www.nuget.org/packages/Newtonsoft.Json) package, and then select **Install** to install the latest stable version.
 
 1. Accept all agreements and licenses to start the installation.
 
@@ -51,7 +44,9 @@ The first step is to make sure that you have your project open in Visual Studio.
 Let's add some code that works as a skeleton for our project.
 
 [!code-csharp[](~/samples-cognitive-services-speech-sdk/quickstart/csharp/dotnet/from-blob/program.cs?range=6-43,138,277)]
-(You'll need to replace the values of `YourSubscriptionKey`, `YourServiceRegion`, and `YourFileUrl` with your own values.)
+
+[!INCLUDE [placeholder-replacements](../placeholder-replacement.md)]
+
 ## JSON Wrappers
 
 As the REST API's take requests in JSON format and also return results in JSON we could interact with them using only strings, but that's not recommended.
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/java/jre.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/java/jre.md
@@ -1,27 +1,21 @@
 ---
-title: "Quickstart: Recognize speech stored in blob storage, Java - Speech service"
-titleSuffix: Azure Cognitive Services
-description: TBD
-services: cognitive-services
-author: erhopf
-manager: nitinme
+author: IEvangelist
 ms.service: cognitive-services
-ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
-ms.author: erhopf
-zone_pivot_groups: programming-languages-set-two
+ms.date: 01/13/2020
+ms.author: dapine
 ---
 
 ## Prerequisites
 
 Before you get started, make sure to:
 
 > [!div class="checklist"]
-> * [Create an Azure Speech Resource](../../../../get-started.md)
-> * [Upload a source file to an azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
-> * [Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=dotnet)
-> * [Create an empty sample project](../../../../quickstarts/create-project.md?tabs=dotnet)
+> * [Setup your development environment](../../../../quickstarts/setup-platform.md?tabs=jre&pivots=programmming-language-java)
+> * [Create an empty sample project](../../../../quickstarts/create-project.md?pivots=programmming-language-java)
+> * [Create an Azure Speech resource](../../../../get-started.md)
+> * [Upload a source file to an Azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
+
 
 ## Open your project in Eclipse
 
@@ -41,7 +35,8 @@ Open your pom.xml and add the following reference:
 Let's add some code that works as a skeleton for our project.
 
 [!code-java[](~/samples-cognitive-services-speech-sdk/quickstart/java/jre/from-blob/src/quickstart/Main.java?range=1-13,95-105,206-207)]
-(You'll need to replace the values of `YourSubscriptionKey`, `YourServiceRegion`, and `YourFileUrl` with your own values.)
+
+[!INCLUDE [placeholder-replacements](../placeholder-replacement.md)]
 
 ## JSON Wrappers
 
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/placeholder-replacement.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/placeholder-replacement.md
@@ -0,0 +1,21 @@
+---
+title: "Quickstart: Recognize speech stored in blob storage - Speech service"
+titleSuffix: Azure Cognitive Services
+services: cognitive-services
+author: IEvangelist
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: speech-service
+ms.topic: include
+ms.date: 01/13/2020
+ms.author: dapine
+---
+
+You'll need to replace the following values:
+
+ - `YourSubscriptionKey`: found in the the **Keys** page of the Azure portal for the Speech resource
+ - `YourServiceRegion`: found in the the **Overview** page of the Azure portal for the Speech resource
+ - `YourFileUrl`: found in under the **Blob service / Containers** page of the Azure portal for the Storage account resource
+     - Select the appropriate container
+     - Select the desired blob
+     - Copy the **URL** under the **Properties** page
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/python/python.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/from-blob/python/python.md
@@ -1,27 +1,20 @@
 ---
-title: "Quickstart: Recognize speech stored in blob storage, C# - Speech service"
-titleSuffix: Azure Cognitive Services
-description: TBD
-services: cognitive-services
-author: erhopf
-manager: nitinme
+author: IEvangelist
 ms.service: cognitive-services
-ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
-ms.author: erhopf
-zone_pivot_groups: programming-languages-set-two
+ms.date: 01/13/2020
+ms.author: dapine
 ---
 
 ## Prerequisites
 
 Before you get started, make sure to:
 
 > [!div class="checklist"]
-> * [Create an Azure Speech Resource](../../../../get-started.md)
-> * [Upload a source file to an azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
 > * [Setup your development environment](../../../../quickstarts/setup-platform.md)
 > * [Create an empty sample project](../../../../quickstarts/create-project.md)
+> * [Create an Azure Speech resource](../../../../get-started.md)
+> * [Upload a source file to an Azure blob](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal)
 
 ## Download and install the API client library
 
@@ -38,7 +31,7 @@ Follow these steps for the installation:
 1. Install the extracted python-client module in your Python environment using pip: `pip install path/to/package/python-client`.
 1. The installed package has the name `swagger_client`. You can check that the installation worked using the command `python -c "import swagger_client"`.
 
-> **Note:**
+> [!NOTE]
 > Due to a [known bug in the Swagger autogeneration](https://github.com/swagger-api/swagger-codegen/issues/7541), you might encounter errors on importing the `swagger_client` package.
 > These can be fixed by deleting the line with the content
 > ```py
@@ -63,7 +56,8 @@ pip install requests
 Let's add some code that works as a skeleton for our project.
 
 [!code-python[](~/samples-cognitive-services-speech-sdk/quickstart/python/from-blob/python-client/main.py?range=1-2,7-34,115-119)]
-(You'll need to replace the values of `YourSubscriptionKey`, `YourServiceRegion`, and `YourFileUrl` with your own values.)
+
+[!INCLUDE [placeholder-replacements](../placeholder-replacement.md)]
 
 ## Create and configure an Http Client
 The first thing we'll need is an Http Client that has a correct base URL and authentication set.
