Merge pull request #208316 from gmndrg/main

v-regandowner · web-flow · commit 63ac1614fc85 · 2022-08-18T13:15:13.000-04:00
Update skill versions to reflect v2 in retired skills
diff --git a/articles/search/TOC.yml b/articles/search/TOC.yml
@@ -573,9 +573,9 @@
         href: cognitive-search-skill-custom-entity-lookup.md 
       - name: Document Extraction
         href: cognitive-search-skill-document-extraction.md
-      - name: Entity Linking (V3)
+      - name: Entity Linking (v3)
         href: cognitive-search-skill-entity-linking-v3.md
-      - name: Entity Recognition (V3)
+      - name: Entity Recognition (v3)
         href: cognitive-search-skill-entity-recognition-v3.md
       - name: Image Analysis
         href: cognitive-search-skill-image-analysis.md
@@ -587,7 +587,7 @@
         href: cognitive-search-skill-ocr.md
       - name: PII Detection
         href: cognitive-search-skill-pii-detection.md  
-      - name: Sentiment (V3)
+      - name: Sentiment (v3)
         href: cognitive-search-skill-sentiment-v3.md
       - name: Shaper
         href: cognitive-search-skill-shaper.md
@@ -606,11 +606,11 @@
     - name: Deprecated skills
       href: cognitive-search-skill-deprecated.md
       items:
-      - name: Named Entity Recognition
+      - name: Named Entity Recognition (v2)
         href: cognitive-search-skill-named-entity-recognition.md
-      - name: Entity Recognition
+      - name: Entity Recognition (v2)
         href: cognitive-search-skill-entity-recognition.md
-      - name: Sentiment
+      - name: Sentiment (v2)
         href: cognitive-search-skill-sentiment.md
 - name: Resources
   items:
diff --git a/articles/search/cognitive-search-skill-deprecated.md b/articles/search/cognitive-search-skill-deprecated.md
@@ -7,23 +7,23 @@ author: LiamCavanagh
 ms.author: liamca
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 09/16/2021
+ms.date: 08/17/2022
 ---
 
 # Deprecated Cognitive Skills in Azure Cognitive Search
 
-This document describes cognitive skills that are considered deprecated. Use the following guide for the contents:
+This document describes cognitive skills that are considered deprecated (retired). Use the following guide for the contents:
 
 * Skill Name: The name of the skill that will be deprecated; it maps to the @odata.type attribute.
 * Last available api version: The last version of the Azure Cognitive Search public API through which skillsets containing the corresponding deprecated skill can be created/updated. Indexers with attached skillsets with these skills will continue to run even in future API versions until the "End of support" date, at which point they will start failing.
 * End of support: The day after which the corresponding skill is considered unsupported and will stop working. Previously created skillsets should still continue to function, but users are recommended to migrate away from a deprecated skill.
 * Recommendations: Migration path forward to use a supported skill. Users are advised to follow the recommendations to continue to receive support.
 
-If you're using the [Microsoft.Skills.Text.EntityRecognitionSkill](#microsoftskillstextentityrecognitionskill), this article will help you upgrade your skillset to use the [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md) which is generally available and introduces new features. 
+If you're using the [Microsoft.Skills.Text.EntityRecognitionSkill](#microsoftskillstextentityrecognitionskill) (Entity Recognition cognitive skill (v2)), this article will help you upgrade your skillset to use the [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md) which is generally available and introduces new features. 
 
-If you're using the [Microsoft.Skills.Text.SentimentSkill](#microsoftskillstextsentimentskill), this article will help you upgrade your skillset to use the [Microsoft.Skills.Text.V3.SentimentSkill](cognitive-search-skill-sentiment-v3.md) which is generally available and introduces new features. 
+If you're using the [Microsoft.Skills.Text.SentimentSkill](#microsoftskillstextsentimentskill) (Sentiment cognitive skill (v2)), this article will help you upgrade your skillset to use the [Microsoft.Skills.Text.V3.SentimentSkill](cognitive-search-skill-sentiment-v3.md) which is generally available and introduces new features. 
 
-If you're using the [Microsoft.Skills.Text.NamedEntityRecognitionSkill](#microsoftskillstextnamedentityrecognitionskill), this article will help you upgrade your skillset to use the [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md) which is generally available and introduces new features.
+If you're using the [Microsoft.Skills.Text.NamedEntityRecognitionSkill](#microsoftskillstextnamedentityrecognitionskill) (Named Entity Recognition cognitive skill (v2)), this article will help you upgrade your skillset to use the [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md) which is generally available and introduces new features.
 
 ## Microsoft.Skills.Text.EntityRecognitionSkill
 
@@ -588,4 +588,4 @@ To migrate to the [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-se
 + [Built-in skills](cognitive-search-predefined-skills.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
 + [Entity Recognition Skill (V3)](cognitive-search-skill-entity-recognition-v3.md)
-+ [Sentiment Skill (V3)](cognitive-search-skill-sentiment-v3.md)
++ [Sentiment Skill (V3)](cognitive-search-skill-sentiment-v3.md)
diff --git a/articles/search/cognitive-search-skill-entity-linking-v3.md b/articles/search/cognitive-search-skill-entity-linking-v3.md
@@ -1,5 +1,5 @@
 ---
-title: Entity Linking cognitive skill
+title: Entity Linking cognitive skill (v3)
 titleSuffix: Azure Cognitive Search
 description: Extract different linked entities from text in an enrichment pipeline in Azure Cognitive Search.
 
@@ -8,12 +8,12 @@ author: nitinme
 ms.author: nitinme
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 12/09/2021
+ms.date: 08/17/2022
 ---
 
-# Entity Linking cognitive skill
+# Entity Linking cognitive skill (v3)
 
-The **Entity Linking** skill returns a list of recognized entities with links to articles in a well-known knowledge base (Wikipedia).
+The **Entity Linking** skill (v3) returns a list of recognized entities with links to articles in a well-known knowledge base (Wikipedia).
 
 > [!NOTE]
 > This skill is bound to the [Entity Linking](../cognitive-services/language-service/entity-linking/overview.md) machine learning models in [Azure Cognitive Services for Language](../cognitive-services/language-service/overview.md) and requires [a billable resource](cognitive-search-attach-cognitive-services.md) for transactions that exceed 20 documents per indexer per day. Execution of built-in skills is charged at the existing [Cognitive Services pay-as-you go price](https://azure.microsoft.com/pricing/details/cognitive-services/).
@@ -136,4 +136,4 @@ If the language code for the document is unsupported, a warning is returned and
 ## See also
 
 + [Built-in skills](cognitive-search-predefined-skills.md)
-+ [How to define a skillset](cognitive-search-defining-skillset.md)
++ [How to define a skillset](cognitive-search-defining-skillset.md)
diff --git a/articles/search/cognitive-search-skill-entity-recognition-v3.md b/articles/search/cognitive-search-skill-entity-recognition-v3.md
@@ -1,5 +1,5 @@
 ---
-title: Entity Recognition (V3) cognitive skill
+title: Entity Recognition cognitive skill (v3) 
 titleSuffix: Azure Cognitive Search
 description: Extract different types of entities using the machine learning models of Azure Cognitive Services for Language in an AI enrichment pipeline in Azure Cognitive Search.
 
@@ -8,12 +8,12 @@ author: nitinme
 ms.author: nitinme
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 12/09/2021
+ms.date: 08/17/2022
 ---
 
-# Entity Recognition cognitive skill (V3)
+# Entity Recognition cognitive skill (v3)
 
-The **Entity Recognition** skill extracts entities of different types from text. These entities fall under 14 distinct categories, ranging from people and organizations to URLs and phone numbers. This skill uses the [Named Entity Recognition](../cognitive-services/language-service/named-entity-recognition/overview.md) machine learning models provided by [Azure Cognitive Services for Language](../cognitive-services/language-service/overview.md).
+The **Entity Recognition** skill (v3) extracts entities of different types from text. These entities fall under 14 distinct categories, ranging from people and organizations to URLs and phone numbers. This skill uses the [Named Entity Recognition](../cognitive-services/language-service/named-entity-recognition/overview.md) machine learning models provided by [Azure Cognitive Services for Language](../cognitive-services/language-service/overview.md).
 
 > [!NOTE]
 > This skill is bound to Cognitive Services and requires [a billable resource](cognitive-search-attach-cognitive-services.md) for transactions that exceed 20 documents per indexer per day. Execution of built-in skills is charged at the existing [Cognitive Services pay-as-you go price](https://azure.microsoft.com/pricing/details/cognitive-services/).
diff --git a/articles/search/cognitive-search-skill-entity-recognition.md b/articles/search/cognitive-search-skill-entity-recognition.md
@@ -1,21 +1,21 @@
 ---
-title: Entity Recognition cognitive skill
+title: Entity Recognition cognitive skill (v2)
 titleSuffix: Azure Cognitive Search
 description: Extract different types of entities from text in an enrichment pipeline in Azure Cognitive Search.
 
 author: LiamCavanagh
 ms.author: liamca
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 09/24/2021
+ms.date: 08/17/2022
 ---
 
-# Entity Recognition cognitive skill
+# Entity Recognition cognitive skill (v2)
 
-The **Entity Recognition** skill extracts entities of different types from text. This skill uses the machine learning models provided by [Text Analytics](../cognitive-services/text-analytics/overview.md) in Cognitive Services.
+The **Entity Recognition** skill (v2) extracts entities of different types from text. This skill uses the machine learning models provided by [Text Analytics](../cognitive-services/text-analytics/overview.md) in Cognitive Services.
 
 > [!IMPORTANT]
-> The Entity Recognition skill is now discontinued replaced by [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md). Follow the recommendations in [Deprecated cognitive search skills](cognitive-search-skill-deprecated.md) to migrate to a supported skill.
+> The Entity Recognition skill (v2) (**Microsoft.Skills.Text.EntityRecognitionSkill**) is now discontinued replaced by [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md). Follow the recommendations in [Deprecated cognitive search skills](cognitive-search-skill-deprecated.md) to migrate to a supported skill.
 
 > [!NOTE]
 > As you expand scope by increasing the frequency of processing, adding more documents, or adding more AI algorithms, you will need to [attach a billable Cognitive Services resource](cognitive-search-attach-cognitive-services.md). Charges accrue when calling APIs in Cognitive Services, and for image extraction as part of the document-cracking stage in Azure Cognitive Search. There are no charges for text extraction from documents.
@@ -194,4 +194,4 @@ If the language code for the document is unsupported, a warning is returned and
 
 + [Built-in skills](cognitive-search-predefined-skills.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Entity Recognition Skill (V3)](cognitive-search-skill-entity-recognition-v3.md)
++ [Entity Recognition Skill (V3)](cognitive-search-skill-entity-recognition-v3.md)
diff --git a/articles/search/cognitive-search-skill-named-entity-recognition.md b/articles/search/cognitive-search-skill-named-entity-recognition.md
@@ -1,21 +1,21 @@
 ---
-title: Named Entity Recognition cognitive skill
+title: Named Entity Recognition cognitive skill (v2)
 titleSuffix: Azure Cognitive Search
 description: Extract named entities for person, location and organization from text in an AI enrichment pipeline in Azure Cognitive Search.
 
 author: LiamCavanagh
 ms.author: liamca
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 08/12/2021
+ms.date: 08/17/2022
 ---
 
-#	Named Entity Recognition cognitive skill
+#	Named Entity Recognition cognitive skill (v2)
 
-The **Named Entity Recognition** skill extracts named entities from text. Available entities include the types `person`, `location` and `organization`.
+The **Named Entity Recognition** skill (v2) extracts named entities from text. Available entities include the types `person`, `location` and `organization`.
 
 > [!IMPORTANT]
-> Named entity recognition skill is now discontinued replaced by [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md). Follow the recommendations in [Deprecated cognitive search skills](cognitive-search-skill-deprecated.md) to migrate to a supported skill.
+> Named entity recognition skill (v2) (**Microsoft.Skills.Text.NamedEntityRecognitionSkill**) is now discontinued replaced by [Microsoft.Skills.Text.V3.EntityRecognitionSkill](cognitive-search-skill-entity-recognition-v3.md). Follow the recommendations in [Deprecated cognitive search skills](cognitive-search-skill-deprecated.md) to migrate to a supported skill.
 
  > [!NOTE]
 > As you expand scope by increasing the frequency of processing, adding more documents, or adding more AI algorithms, you will need to [attach a billable Cognitive Services resource](cognitive-search-attach-cognitive-services.md). Charges accrue when calling APIs in Cognitive Services, and for image extraction as part of the document-cracking stage in Azure Cognitive Search. There are no charges for text extraction from documents. Execution of built-in skills is charged at the existing [Cognitive Services pay-as-you go price](https://azure.microsoft.com/pricing/details/cognitive-services/).
@@ -153,4 +153,4 @@ If the language code for the document is unsupported, a warning is returned and
 
 + [Built-in skills](cognitive-search-predefined-skills.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Entity Recognition Skill (V3)](cognitive-search-skill-entity-recognition-v3.md)
++ [Entity Recognition Skill (V3)](cognitive-search-skill-entity-recognition-v3.md)
diff --git a/articles/search/cognitive-search-skill-sentiment-v3.md b/articles/search/cognitive-search-skill-sentiment-v3.md
@@ -1,5 +1,5 @@
 ---
-title: Sentiment cognitive skill (V3)
+title: Sentiment cognitive skill (v3)
 titleSuffix: Azure Cognitive Search
 description: Provides sentiment labels for text in an AI enrichment pipeline in Azure Cognitive Search.
 
@@ -8,12 +8,12 @@ author: careyjmac
 ms.author: chalton
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 12/09/2021
+ms.date: 08/17/2022
 ---
 
-# Sentiment cognitive skill (V3)
+# Sentiment cognitive skill (v3)
 
-The V3 **Sentiment** skill evaluates unstructured text and for each record, provides sentiment labels (such as "negative", "neutral" and "positive") based on the highest confidence score found by the service at a sentence and document-level. This skill uses the machine learning models provided by version 3 of [Language Service](../cognitive-services/language-service/overview.md) in Cognitive Services. It also exposes [opinion mining capabilities](../cognitive-services/language-service/sentiment-opinion-mining/overview.md), which provides more granular information about the opinions related to attributes of products or services in text.
+The **Sentiment** skill (v3) evaluates unstructured text and for each record, provides sentiment labels (such as "negative", "neutral" and "positive") based on the highest confidence score found by the service at a sentence and document-level. This skill uses the machine learning models provided by version 3 of [Language Service](../cognitive-services/language-service/overview.md) in Cognitive Services. It also exposes [opinion mining capabilities](../cognitive-services/language-service/sentiment-opinion-mining/overview.md), which provides more granular information about the opinions related to attributes of products or services in text.
 
 > [!NOTE]
 > This skill is bound to Cognitive Services and requires [a billable resource](cognitive-search-attach-cognitive-services.md) for transactions that exceed 20 documents per indexer per day. Execution of built-in skills is charged at the existing [Cognitive Services pay-as-you go price](https://azure.microsoft.com/pricing/details/cognitive-services/).
@@ -216,4 +216,4 @@ If a language is not supported, a warning is generated and no sentiment results
 ## See also
 
 + [Built-in skills](cognitive-search-predefined-skills.md)
-+ [How to define a skillset](cognitive-search-defining-skillset.md)
++ [How to define a skillset](cognitive-search-defining-skillset.md)
diff --git a/articles/search/cognitive-search-skill-sentiment.md b/articles/search/cognitive-search-skill-sentiment.md
@@ -1,21 +1,21 @@
 ---
-title: Sentiment cognitive skill
+title: Sentiment cognitive skill (v2)
 titleSuffix: Azure Cognitive Search
 description: Extract a positive-negative sentiment score from text in an AI enrichment pipeline in Azure Cognitive Search.
 
 author: LiamCavanagh
 ms.author: liamca
 ms.service: cognitive-search
 ms.topic: reference
-ms.date: 09/17/2021
+ms.date: 08/17/2022
 ---
 
-# Sentiment cognitive skill
+# Sentiment cognitive skill (v2)
 
-The **Sentiment** skill evaluates unstructured text along a positive-negative continuum, and for each record, returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, and scores close to 0 indicate negative sentiment. This skill uses the machine learning models provided by [Text Analytics](../cognitive-services/text-analytics/overview.md) in Cognitive Services.
+The **Sentiment** skill (v2) evaluates unstructured text along a positive-negative continuum, and for each record, returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, and scores close to 0 indicate negative sentiment. This skill uses the machine learning models provided by [Text Analytics](../cognitive-services/text-analytics/overview.md) in Cognitive Services.
 
 > [!IMPORTANT]
-> The Sentiment skill is now discontinued replaced by [Microsoft.Skills.Text.V3.SentimentSkill](cognitive-search-skill-sentiment-v3.md). Follow the recommendations in [Deprecated cognitive search skills](cognitive-search-skill-deprecated.md) to migrate to a supported skill.
+> The Sentiment skill (v2) (**Microsoft.Skills.Text.SentimentSkill**) is now discontinued replaced by [Microsoft.Skills.Text.V3.SentimentSkill](cognitive-search-skill-sentiment-v3.md). Follow the recommendations in [Deprecated cognitive search skills](cognitive-search-skill-deprecated.md) to migrate to a supported skill.
 
 > [!NOTE]
 > As you expand scope by increasing the frequency of processing, adding more documents, or adding more AI algorithms, you will need to [attach a billable Cognitive Services resource](cognitive-search-attach-cognitive-services.md). Charges accrue when calling APIs in Cognitive Services, and for image extraction as part of the document-cracking stage in Azure Cognitive Search. There are no charges for text extraction from documents.
@@ -116,4 +116,4 @@ If a language is not supported, a warning is generated and no sentiment score is
 
 + [Built-in skills](cognitive-search-predefined-skills.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Sentiment Skill (V3)](cognitive-search-skill-sentiment-v3.md)
++ [Sentiment Skill (V3)](cognitive-search-skill-sentiment-v3.md)
