[CogSvcs] added specific instructions for replacing values

IEvangelist · IEvangelist · commit 5e410051c19c · 2020-01-13T10:53:38.000-06:00
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
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
+ms.date: 01/13/2020
 ms.author: erhopf
 zone_pivot_groups: programming-languages-set-two
 ---
@@ -18,10 +18,10 @@ zone_pivot_groups: programming-languages-set-two
 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 +50,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-replacements.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
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
+ms.date: 01/13/2020
 ms.author: erhopf
 zone_pivot_groups: programming-languages-set-two
 ---
@@ -18,10 +18,10 @@ zone_pivot_groups: programming-languages-set-two
 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 +30,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 +40,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 +51,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-replacements.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
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
+ms.date: 01/13/2020
 ms.author: erhopf
 zone_pivot_groups: programming-languages-set-two
 ---
@@ -18,10 +18,11 @@ zone_pivot_groups: programming-languages-set-two
 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 +42,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-replacements.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
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 10/28/2019
+ms.date: 01/13/2020
 ms.author: erhopf
 zone_pivot_groups: programming-languages-set-two
 ---
@@ -18,10 +18,10 @@ zone_pivot_groups: programming-languages-set-two
 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
 
@@ -63,7 +63,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-replacements.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.
