Merge pull request #42274 from v-geberr/0525-move-qs-to-tutorial

move quickstarts to tutorials - part of new Azure standards alignment…

Author: TrishaMc

.openpublishing.redirection.json

@@ -21940,6 +21940,41 @@
             "source_path": "articles/security/azure-security-getting-started.md",
             "redirect_url": "https://docs.microsoft.com/azure/security",
             "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-cs-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-cs-add-utterance",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-java-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-java-add-utterance",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-javascript-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-javascript-add-utterance",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-node-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-node-add-utterance",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-php-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-php-add-utterance",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-python-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-python-add-utterance",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "articles/cognitive-services/LUIS/luis-quickstart-ruby-add-utterance.md",
+            "redirect_url": "/azure/cognitive-services/LUIS/luis-get-started-ruby-add-utterance",
+            "redirect_document_id": true
         }
     ]
 }

articles/cognitive-services/LUIS/luis-quickstart-cs-add-utterance.md renamed to articles/cognitive-services/LUIS/luis-get-started-cs-add-utterance.md

@@ -1,21 +1,28 @@
 ---
-title: Add utterances to a LUIS app using C# | Microsoft Docs
-description: Learn to call a LUIS app using C# in this quickstart.
+title: Tutorial learning how to add utterances to a LUIS app using C# | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using C# in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
 ms.service: cognitive-services
 ms.component: language-understanding
-ms.topic: quickstart
+ms.topic: tutorial
 ms.date: 02/20/2018
 ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to add an utterance to the LUIS app model using C#. 
 ---
 
-# Quickstart: Add utterances to a LUIS app using C# 
+# Tutorial: Add utterances to a LUIS app using C# 
 In this quickstart, write a program to add an utterance to an intent using the Authoring APIs in C#.
 
-For more information, see the technical documentation for the [add utterance](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create Visual Studio console project 
+> * Add method to call LUIS API to add utterance and train app
+> * Add JSON file with example utterances for BookFlight intent
+> * Run console and see training status for utterances
+
+For more information, see the technical documentation for the [add example utterance to intent](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
 
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
@@ -30,7 +37,6 @@ For this article, you need a free [LUIS][LUIS] account in order to author your L
 > [!NOTE] 
 > The complete C# solution including an example `utterances.json` file are available from the [**LUIS-Samples** Github repository](https://github.com/Microsoft/LUIS-Samples/blob/master/documentation-samples/authoring-api-samples/csharp/).
 
-
 ## Create the project in Visual Studio
 
 In Visual Studio, create a new **Windows Classic Desktop Console** app using the .Net Framework. 
@@ -297,12 +303,11 @@ Requested training status.
 ]
 ```
 
-## Next steps
+## Clean up resources
+When you are done with the tutorial, remove Visual Studio and the console application if you don't need them anymore. 
 
- 
+## Next steps
 > [!div class="nextstepaction"] 
 > [Build a LUIS app programmatically](luis-tutorial-node-import-utterances-csv.md) 
 
-> [Authoring APIs](https://aka.ms/luis-authoring-api)
-
 [LUIS]: luis-reference-regions.md#luis-website

articles/cognitive-services/LUIS/luis-get-started-cs-get-intent.md

@@ -1,24 +1,31 @@
 ---
-title: Call a Language Understanding (LUIS) app using C# | Microsoft Docs
-description: Learn to call a LUIS app using C# in this quickstart.
+title: Tutorial learning how to call a Language Understanding (LUIS) app using C# | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using C# in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
 ms.service: cognitive-services
 ms.component: language-understanding
-ms.topic: quickstart
+ms.topic: tutorial
 ms.date: 12/13/2017
 ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to query the endpoint of a published model using C#. 
 ---
 
-# Quickstart: Call a LUIS endpoint using C#
+# Tutorial: Call a LUIS endpoint using C#
 
 Pass utterances to a LUIS endpoint and get intent and entities back.
 
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create LUIS subscription and copy key value for later use
+> * View LUIS endpoint results from browser to public sample IoT app
+> * Create Visual Studio C# console app to make HTTPS call to LUIS endpoint
+
+<!-- link to free account -->
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
-## Before you begin
+## Create LUIS subscription key
 1. You first need to create a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) in the Azure portal. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
 2. Log in to the Azure portal at https://portal.azure.com. 
@@ -57,6 +64,9 @@ You can use C# to access the same results you saw in the browser window in the p
 
 ![Console window displays JSON result from LUIS](./media/luis-get-started-cs-get-intent/console-turn-on.png)
 
+## Clean up resources
+The two resources created in this tutorial are the LUIS subscription key and the C# project. Delete the LUIS subscription key from the Azure portal. Close the Visual Studio project and remove the directory from the file system. 
+
 ## Next steps
 > [!div class="nextstepaction"]
 > [Add utterances](luis-quickstart-cs-add-utterance.md)

articles/cognitive-services/LUIS/luis-quickstart-java-add-utterance.md renamed to articles/cognitive-services/LUIS/luis-get-started-java-add-utterance.md

@@ -1,21 +1,28 @@
 ---
-title: Add utterances to a LUIS app using Java | Microsoft Docs
-description: Learn to call a LUIS app using Java in this quickstart.
+title: Tutorial learning how to add utterances to a LUIS app using Java | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using Java in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
 ms.service: cognitive-services
 ms.component: language-understanding
-ms.topic: quickstart
+ms.topic: tutorial
 ms.date: 12/13/2017
 ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to add an utterance to the LUIS app model using Java. 
 ---
 
-# Quickstart: Add utterances to app using Java 
+# Tutorial: Add utterances to app using Java 
 In this quickstart, write a program to add an utterance to an intent using the Authoring APIs in Java.
 
-For more information, refer to the technical documentation for the [add utterance](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create Visual Studio console project 
+> * Add method to call LUIS API to add utterance and train app
+> * Add JSON file with example utterances for BookFlight intent
+> * Run console and see training status for utterances
+
+For more information, see the technical documentation for the [add example utterance to intent](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
 
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
@@ -171,12 +178,11 @@ Call the app with the `-status` argument to check the training status and write
 > java -classpath .;gson-2.8.2.jar AddUtterances -status
 ````
 
-## Next steps
+## Clean up resources
+When you are done with the tutorial, remove Visual Studio and the console application if you don't need them anymore. 
 
+## Next steps
 > [!div class="nextstepaction"] 
 > [Build a LUIS app programmatically](luis-tutorial-node-import-utterances-csv.md) 
 
-> [Authoring APIs](https://aka.ms/luis-authoring-api)
-
-
 [LUIS]: luis-reference-regions.md#luis-website

articles/cognitive-services/LUIS/luis-get-started-java-get-intent.md

@@ -1,24 +1,29 @@
 ---
-title: Call a Language Understanding (LUIS) app using Java | Microsoft Docs
-description: Learn to call a LUIS app using Java in this quickstart.
+title: Tutorial learning how to call a Language Understanding (LUIS) app using Java | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using Java in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
 ms.service: cognitive-services
 ms.component: language-understanding
-ms.topic: quickstart
+ms.topic: tutorial
 ms.date: 12/13/2017
 ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to query the endpoint of a published model using Java. 
-
 ---
 
-# Quickstart: Call a LUIS endpoint using Java
+# Tutorial: Call a LUIS endpoint using Java
 Pass utterances to a LUIS endpoint and get intent and entities back.
 
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create LUIS subscription and copy key value for later use
+> * View LUIS endpoint results from browser to public sample IoT app
+> * Create Visual Studio C# console app to make HTTPS call to LUIS endpoint
+
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
-## Before you begin
+## Create LUIS subscription key
 You need a Cognitive Services API key to make calls to the sample LUIS app used in this walkthrough. 
 
 To get an API key, follow these steps: 
@@ -59,6 +64,9 @@ You can use Java to access the same results you saw in the browser window in the
 
 ![Console window displays JSON result from LUIS](./media/luis-get-started-java-get-intent/console-turn-on.png)
 
+## Clean up resources
+The two resources created in this tutorial are the LUIS subscription key and the C# project. Delete the LUIS subscription key from the Azure portal. Close the Visual Studio project and remove the directory from the file system.
+
 ## Next steps
 > [!div class="nextstepaction"]
 > [Add utterances](luis-quickstart-java-add-utterance.md)

articles/cognitive-services/LUIS/luis-quickstart-javascript-add-utterance.md renamed to articles/cognitive-services/LUIS/luis-get-started-javascript-add-utterance.md

@@ -1,20 +1,27 @@
 ---
-title: Add utterances to a LUIS app using JavaScript | Microsoft Docs
-description: Learn to call a LUIS app using JavaScript in this quickstart.
+title: Tutorial learning how to add utterances to a LUIS app using JavaScript | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using JavaScript in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
 ms.service: cognitive-services
 ms.component: language-understanding
-ms.topic: quickstart
+ms.topic: tutorial
 ms.date: 12/18/2017
 ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to add an utterance to the LUIS app model using Javascript. 
 ---
-# Quickstart: Add utterances to app using JavaScript
+# Tutorial: Add utterances to app using JavaScript
 In this quickstart, write a program to add an utterance to an intent using the Authoring APIs in Javascript.
 
-For more information, see the technical documentation for the [add utterance](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create Visual Studio console project 
+> * Add method to call LUIS API to add utterance and train app
+> * Add JSON file with example utterances for BookFlight intent
+> * Run console and see training status for utterances
+
+For more information, see the technical documentation for the [add example utterance to intent](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
 
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
@@ -70,6 +77,9 @@ Create `add-utterances.html` and add the following code:
 
 ![Add-utterances.html](./media/luis-quickstart-javascript-add-utterance/add-utterance.png)
 
+## Clean up resources
+When you are done with the tutorial, remove Visual Studio and the console application if you don't need them anymore. 
+
 ## Next steps
 > [!div class="nextstepaction"]
 > [Integrate LUIS with a bot](luis-csharp-tutorial-build-bot-framework-sample.md)

articles/cognitive-services/LUIS/luis-get-started-js-get-intent.md

@@ -1,6 +1,6 @@
 ---
-title: Call a Language Understanding (LUIS) app using Node.js | Microsoft Docs
-description: Learn to call a LUIS app using Node.js in this quickstart.
+title: Tutorial learning how to call a Language Understanding (LUIS) app using Node.js | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using Node.js in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
@@ -12,12 +12,18 @@ ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to query the endpoint of a published model using Javascript. 
 ---
 
-# Quickstart: Call a LUIS endpoint using JavaScript
+# Tutorial: Call a LUIS endpoint using JavaScript
 Pass utterances to a LUIS endpoint and get intent and entities back.
 
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create LUIS subscription and copy key value for later use
+> * View LUIS endpoint results from browser to public sample IoT app
+> * Create Visual Studio C# console app to make HTTPS call to LUIS endpoint
+
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
-## Before you begin
+## Create LUIS subscription key
 You need a Cognitive Services API key to make calls to the sample LUIS app used in this walkthrough. 
 
 To get an API key, follow these steps: 
@@ -59,6 +65,9 @@ You can use JavaScript to access the same results you saw in the browser window
 
 ![Popup that says TurnOn](./media/luis-get-started-node-get-intent/popup-turn-on.png)
 
+## Clean up resources
+The two resources created in this tutorial are the LUIS subscription key and the C# project. Delete the LUIS subscription key from the Azure portal. Close the Visual Studio project and remove the directory from the file system. 
+
 ## Next steps
 > [!div class="nextstepaction"]
 > [Add utterances](luis-quickstart-javascript-add-utterance.md)

articles/cognitive-services/LUIS/luis-quickstart-node-add-utterance.md renamed to articles/cognitive-services/LUIS/luis-get-started-node-add-utterance.md

@@ -1,23 +1,29 @@
 ---
-title: Add utterances to a LUIS app using Node.js | Microsoft Docs
-description: Learn to call a LUIS app using Node.js in this quickstart.
+title: Tutorial learning how to add utterances to a LUIS app using Node.js | Microsoft Docs
+description: In this tutorial, you learn to call a LUIS app using Node.js in this quickstart.
 services: cognitive-services
 author: v-geberr
 manager: kaiqb
 ms.service: cognitive-services
 ms.component: language-understanding
-ms.topic: quickstart
+ms.topic: tutorial
 ms.date: 12/13/2017
 ms.author: v-geberr
 #Customer intent: As a developer new to LUIS, I want to add an utterance to the LUIS app model using Node.js. 
 ---
 
-# Quickstart: Add utterances app using Node.js 
+# Tutorial: Add utterances app using Node.js 
 In this quickstart, you write a program to add an utterance to an intent using the Authoring APIs in Node.js.
 
+<!-- green checkmark -->
+> [!div class="checklist"]
+> * Create Visual Studio console project 
+> * Add method to call LUIS API to add utterance and train app
+> * Add JSON file with example utterances for BookFlight intent
+> * Run console and see training status for utterances
 
 For more information, 
-refer to the technical documentation for the [add utterance](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
+refer to the technical documentation for the [add example utterance to intent](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c08), [train](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c45), and [training status](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c46) APIs.
 
 For this article, you need a free [LUIS][LUIS] account in order to author your LUIS application.
 
@@ -171,12 +177,11 @@ Call the sample with the `-status` argument to check the training status and wri
 > node add-utterances.js -status
 ````
 
-## Next steps
+## Clean up resources
+When you are done with the tutorial, remove Visual Studio and the console application if you don't need them anymore. 
 
- 
+## Next steps
 > [!div class="nextstepaction"] 
 > [Build a LUIS app programmatically](luis-tutorial-node-import-utterances-csv.md)
 
-> [Authoring APIs](https://aka.ms/luis-authoring-api)
-
 [LUIS]: luis-reference-regions.md#luis-website