java verified, php verified

Author: diberry

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

@@ -1,7 +1,6 @@
 ---
-title: Quickstart learning how to call a Language Understanding (LUIS) app using Java | Microsoft Docs
-description: In this quickstart, you learn to call a LUIS app using Java.
-services: cognitive-services
+title: Analyze natural language text in Language Understanding (LUIS) using Java - Cognitive Services - Azure Cognitive Services | Microsoft Docs
+description: In this quickstart, use an available public LUIS app to determine a user's intention from conversational text. Using Java, send the user's intention as text to the public app's HTTP prediction endpoint. At the endpoint, LUIS applies the public app's model to analyze the natural language text for meaning, determining overall intent and extracting data relevant to the app's subject domain.  
 author: diberry
 manager: cjgronlund
 ms.service: cognitive-services
@@ -12,63 +11,52 @@ ms.author: diberry
 #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
-In this quickstart, pass utterances to a LUIS endpoint and get intent and entities back.
+# Quickstart: Analyze text using Java
 
-<!-- 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-reference-regions.md#luis-website) account in order to author your LUIS application.
+[!include[Quickstart introduction for endpoint](../../../includes/cognitive-services-luis-qs-endpoint-intro-para.md)]
 
 <a name="create-luis-subscription-key"></a>
-## Create LUIS endpoint 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: 
-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.
+## Prerequisites
 
-2. Log in to the Azure portal at https://portal.azure.com. 
+* [JDK SE)](http://www.oracle.com/technetwork/java/javase/downloads/index.html)  (Java Development Kit, Standard Edition
+* [Visual Studio Code](https://code.visualstudio.com/)
+* Public app ID: df67dcdb-c37d-46af-88e1-8b97951ca1c2
 
-3. Follow the steps in [Creating Endpoint Keys using Azure](./luis-how-to-azure-subscription.md) to get a key.
 
-4. Go back to the [LUIS](luis-reference-regions.md) website and log in using your Azure account. 
+[!include[Use authoring key for endpoint](../../../includes/cognitive-services-luis-qs-endpoint-luis-repo-note.md)]
 
-    [![](media/luis-get-started-java-get-intent/app-list.png "Screenshot of App list")](media/luis-get-started-java-get-intent/app-list.png)
+## Get LUIS key
 
-## Understand what LUIS returns
+[!include[Use authoring key for endpoint](../../../includes/cognitive-services-luis-qs-endpoint-get-key-para.md)]
 
-To understand what a LUIS app returns, you can paste the URL of a sample LUIS app into a browser window. The sample app is an IoT app that detects whether the user wants to turn on or turn off lights.
+## Analyze text with browser
 
-1. The endpoint of the sample app is in this format: `https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2?subscription-key=<YOUR_API_KEY>&verbose=false&q=turn%20on%20the%20bedroom%20light` Copy the URL and substitute your subscription key for the value of the `subscription-key` field.
-2. Paste the URL into a browser window and press Enter. The browser displays a JSON result that indicates that LUIS detects the `HomeAutomation.TurnOn` intent and the `HomeAutomation.Room` entity with the value `bedroom`.
+[!include[Use authoring key for endpoint](../../../includes/cognitive-services-luis-qs-endpoint-browser-para.md)]
 
-    ![JSON result detects the intent TurnOn](./media/luis-get-started-java-get-intent/turn-on-bedroom.png)
-3. Change the value of the `q=` parameter in the URL to `turn off the living room light`, and press enter. The result now indicates that the LUIS detected the `HomeAutomation.TurnOff` intent and the `HomeAutomation.Room` entity with value `living room`. 
+## Analyze text with Java 
 
-    ![JSON result detects the intent TurnOff](./media/luis-get-started-java-get-intent/turn-off-living-room.png)
+You can use Java to access the same results you saw in the browser window in the previous step. 
 
+1. Copy the following code to create a class in your IDE:
 
-## Consume a LUIS result using the Endpoint API with Java 
+   [!code-java[Console app code that calls a LUIS endpoint](~/samples-luis/documentation-samples/quickstarts/analyze-text/java/call-endpoint.java)]
 
-You can use Java to access the same results you saw in the browser window in the previous step. 
-1. Copy the following code to create a class in your IDE:
+2. Replace the value of the `YOUR-KEY` variable with your LUIS key.
 
-   [!code-java[Console app code that calls a LUIS endpoint](~/samples-luis/documentation-samples/endpoint-api-samples/java/call-endpoint.java)]
-2. Replace the value of the `SubscriptionKey` variable with your LUIS endpoint key.
+3. In your IDE, add references to `httpclient` and `httpcore` libraries. Compile the java program. 
 
-3. In your IDE, add references to `httpclient` and `httpcore` libraries.
+4. Run the application. It displays the same JSON that you saw earlier in the browser window.
 
-4. Run the console application. It displays the same JSON that you saw earlier in the browser window.
+    ![Console window displays JSON result from LUIS](./media/luis-get-started-java-get-intent/console-turn-on.png)
+    
+## LUIS keys
 
-![Console window displays JSON result from LUIS](./media/luis-get-started-java-get-intent/console-turn-on.png)
+[!include[Use authoring key for endpoint](../../../includes/cognitive-services-luis-qs-endpoint-key-usage-para.md)]
 
 ## Clean up resources
-The two resources created in this tutorial are the LUIS endpoint key and the C# project. Delete the LUIS endpoint key from the Azure portal. Close the Visual Studio project and remove the directory from the file system.
+
+Delete the Java file. 
 
 ## Next steps
 > [!div class="nextstepaction"]

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

@@ -60,9 +60,9 @@ You can use Python to access the same results you saw in the browser window in t
 
 1. Copy one of the following code snippets:
 
-   [!code-python[Console app code that calls a LUIS endpoint for Python 2.7](~/samples-luis/documentation-samples/endpoint-api-samples/python/2.x/quickstart-call-endpoint-2-7.py)]
+   [!code-python[Console app code that calls a LUIS endpoint for Python 2.7](~/samples-luis/documentation-samples/quickstarts/analyze-text/python/2.x/quickstart-call-endpoint-2-7.py)]
 
-   [!code-python[Console app code that calls a LUIS endpoint for Python 3.6](~/samples-luis/documentation-samples/endpoint-api-samples/python/3.x/quickstart-call-endpoint-3-6.py)]
+   [!code-python[Console app code that calls a LUIS endpoint for Python 3.6](~/samples-luis/documentation-samples/quickstarts/analyze-text/python/3.x/quickstart-call-endpoint-3-6.py)]
 
 
 2. Replace the value of the `Ocp-Apim-Subscription-Key` field with your LUIS endpoint key.