Merge pull request #222928 from aahill/studio-qs-update

Language studio quickstart, development options for each service

Author: JamesJBarnett

articles/cognitive-services/language-service/entity-linking/how-to/call-api.md

@@ -17,8 +17,10 @@ ms.custom: language-service-entity-linking, ignite-fall-2021
 
 The entity linking feature can be used to identify and disambiguate the identity of an entity found in text (for example, determining whether an occurrence of the word "*Mars*" refers to the planet, or to the Roman god of war). It will return the entities in the text with links to [Wikipedia](https://www.wikipedia.org/) as a knowledge base.
 
-> [!TIP]
-> If you want to start using this feature, you can follow the [quickstart article](../quickstart.md) to get started. You can also make example requests using [Language Studio](../../language-studio.md) without needing to write code.
+
+## Development options
+
+[!INCLUDE [development-options](../includes/development-options.md)]
 
 ## Determine how to process the data (optional)
 
@@ -34,7 +36,7 @@ When you submit documents to be processed by entity linking, you can specify whi
 
 Entity linking produces a higher-quality result when you give it smaller amounts of text to work on. This is opposite from some features, like key phrase extraction which performs better on larger blocks of text. To get the best results from both operations, consider restructuring the inputs accordingly.
 
-To send an API request, You will need a Language resource endpoint and key.
+To send an API request, you will need a Language resource endpoint and key.
 
 > [!NOTE]
 > You can find the key and endpoint for your Language resource on the Azure portal. They will be located on the resource's **Key and endpoint** page, under **resource management**. 

articles/cognitive-services/language-service/entity-linking/includes/development-options.md

@@ -0,0 +1,18 @@
+---
+services: cognitive-services
+author: aahill
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: language-service
+ms.topic: include
+ms.date: 01/06/2023
+ms.author: aahi
+---
+
+To use entity linking, you submit raw unstructured text for analysis and handle the API output in your application. Analysis is performed as-is, with no additional customization to the model used on your data. There are two ways to use entity linking:
+
+
+|Development option  |Description  |
+|---------|---------|
+|Language studio     | Language Studio is a web-based platform that lets you try entity linking with text examples without an Azure account, and your own data when you sign up. For more information, see the [Language Studio website](https://language.cognitive.azure.com/tryout/linkedEntities) or [language studio quickstart](../../language-studio.md).         |
+|REST API or Client library (Azure SDK)      | Integrate entity linking into your applications using the REST API, or the client library available in a variety of languages. For more information, see the [entity linking quickstart](../quickstart.md).        |

articles/cognitive-services/language-service/entity-linking/overview.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: overview
-ms.date: 06/15/2022
+ms.date: 01/10/2023
 ms.author: aahi
 ms.custom: language-service-entity-linking, ignite-fall-2021
 ---
@@ -22,9 +22,9 @@ This documentation contains the following types of articles:
 * [**Quickstarts**](quickstart.md) are getting-started instructions to guide you through making requests to the service.
 * [**How-to guides**](how-to/call-api.md) contain instructions for using the service in more specific ways.
 
-[!INCLUDE [Typical workflow for pre-configured language features](../includes/overview-typical-workflow.md)]
+## Get started with entity linking
 
-The result will be a collection of recognized entities in your text, with URLs to Wikipedia as an online knowledge base. 
+[!INCLUDE [development-options](includes/development-options.md)]
 
 [!INCLUDE [Developer reference](../includes/reference-samples-text-analytics.md)] 
 

articles/cognitive-services/language-service/includes/deploy-azure-resource.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: how-to
-ms.date: 07/27/2022
+ms.date: 01/10/2023
 ms.author: jboback
 ms.custom: language-service-key-phrase, ignite-fall-2021
 ---
@@ -22,6 +22,9 @@ This feature is useful if you need to quickly identify the main points in a coll
 > [!TIP]
 > If you want to start using this feature, you can follow the [quickstart article](../quickstart.md) to get started. You can also make example requests using [Language Studio](../../language-studio.md) without needing to write code.
 
+## Development options
+
+[!INCLUDE [development options](../includes/development-options.md)]
 
 ## Determine how to process the data (optional)
 

articles/cognitive-services/language-service/key-phrase-extraction/how-to/call-api.md

@@ -0,0 +1,19 @@
+---
+services: cognitive-services
+author: aahill
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: language-service
+ms.topic: include
+ms.date: 01/10/2023
+ms.author: aahi
+---
+
+To use key phrase extraction, you submit raw unstructured text for analysis and handle the API output in your application. Analysis is performed as-is, with no additional customization to the model used on your data. There are two ways to use key phrase extraction:
+
+
+|Development option  |Description  |
+|---------|---------|
+|Language studio     | Language Studio is a web-based platform that lets you try entity linking with text examples without an Azure account, and your own data when you sign up. For more information, see the [Language Studio website](https://language.cognitive.azure.com/tryout/keyPhrases) or [language studio quickstart](../../language-studio.md).         |
+|REST API or Client library (Azure SDK)      | Integrate key phrase extraction into your applications using the REST API, or the client library available in a variety of languages. For more information, see the [key phrase extraction quickstart](../quickstart.md).        |
+| Docker container | Use the available Docker container to [deploy this feature on-premises](../how-to/use-containers.md). These docker containers enable you to bring the service closer to your data for compliance, security, or other operational reasons. |

articles/cognitive-services/language-service/key-phrase-extraction/includes/development-options.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: overview
-ms.date: 06/15/2022
+ms.date: 01/10/2023
 ms.author: jboback
 ms.custom: language-service-key-phrase, ignite-fall-2021
 ---
@@ -24,11 +24,12 @@ This documentation contains the following types of articles:
 
 [!INCLUDE [Typical workflow for pre-configured language features](../includes/overview-typical-workflow.md)]
 
-[!INCLUDE [Developer reference](../includes/reference-samples-text-analytics.md)] 
 
-## Deploy on premises using Docker containers
+## Get started with entity linking
+
+[!INCLUDE [development options](./includes/development-options.md)]
 
-Use the available Docker container to [deploy this feature on-premises](how-to/use-containers.md). These docker containers enable you to bring the service closer to your data for compliance, security, or other operational reasons.
+[!INCLUDE [Developer reference](../includes/reference-samples-text-analytics.md)] 
 
 ## Responsible AI 
 

articles/cognitive-services/language-service/key-phrase-extraction/overview.md

@@ -21,8 +21,9 @@ Language detection is useful for content stores that collect arbitrary text, whe
 
 The Language Detection feature can detect a wide range of languages, variants, dialects, and some regional or cultural languages.
 
-> [!TIP]
-> If you want to start using this feature, you can follow the [quickstart article](../quickstart.md) to get started. You can also make example requests using [Language Studio](../../language-studio.md) without needing to write code.
+## Development options
+
+[!INCLUDE [development options](../includes/development-options.md)]
 
 ## Determine how to process the data (optional)
 

articles/cognitive-services/language-service/language-detection/how-to/call-api.md

@@ -0,0 +1,19 @@
+---
+services: cognitive-services
+author: aahill
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: language-service
+ms.topic: include
+ms.date: 01/10/2023
+ms.author: aahi
+---
+
+To use language detection, you submit raw unstructured text for analysis and handle the API output in your application. Analysis is performed as-is, with no additional customization to the model used on your data. There are two ways to use language detection:
+
+
+|Development option  |Description  |
+|---------|---------|
+|Language studio     | Language Studio is a web-based platform that lets you try entity linking with text examples without an Azure account, and your own data when you sign up. For more information, see the [Language Studio website](https://language.cognitive.azure.com/tryout/detectLanguage) or [language studio quickstart](../../language-studio.md).         |
+|REST API or Client library (Azure SDK)      | Integrate language detection into your applications using the REST API, or the client library available in a variety of languages. For more information, see the [language detection quickstart](../quickstart.md).        |
+| Docker container | Use the available Docker container to [deploy this feature on-premises](../how-to/use-containers.md). These docker containers enable you to bring the service closer to your data for compliance, security, or other operational reasons. |

articles/cognitive-services/language-service/language-detection/includes/development-options.md

@@ -24,9 +24,10 @@ This documentation contains the following types of articles:
 
 [!INCLUDE [Typical workflow for pre-configured language features](../includes/overview-typical-workflow.md)]
 
-## Deploy on premises using Docker containers
 
-Use the available Docker container to [deploy this feature on-premises](how-to/use-containers.md). These docker containers enable you to bring the service closer to your data for compliance, security, or other operational reasons.
+## Get started with language detection
+
+[!INCLUDE [development options](./includes/development-options.md)]
 
 ## Responsible AI