Merge pull request #277798 from MicrosoftDocs/main

6/11 11:00 AM IST Publish

Author: PhilKang0704

articles/advisor/advisor-get-started.md

@@ -1,5 +1,5 @@
 ---
-title: Get started with Azure Advisor
+title: Azure Advisor portal basics
 description: Get started with Azure Advisor.
 author: mabrahms
 ms.author: v-mabrahms
@@ -9,7 +9,7 @@ ms.date: 03/07/2024
 
 ---
 
-# Get started with Azure Advisor
+# Azure Advisor portal basics
 
 Learn how to access Advisor through the Azure portal, get and manage recommendations, and configure Advisor settings.
 

articles/advisor/azure-advisor-score.md

@@ -1,12 +1,12 @@
 ---
-title: Optimize Azure workloads by using Advisor score
+title: Use Advisor score
 description: Use Azure Advisor score to get the most out of Azure.
 ms.topic: article
 ms.date: 09/09/2020
 
 ---
 
-# Optimize Azure workloads by using Advisor score
+# Use Advisor score
 
 ## Introduction to Advisor score
 

articles/advisor/permissions.md

@@ -1,11 +1,11 @@
 ---
-title: Permissions in Azure Advisor 
+title: Roles and permissions 
 description: Advisor permissions and how they may block your ability to configure subscriptions or postpone or dismiss recommendations.
 ms.topic: article
-ms.date: 04/03/2019
+ms.date: 05/03/2024
 ---
 
-# Permissions in Azure Advisor
+# Roles and permissions
 
 Azure Advisor provides recommendations based on the usage and configuration of your Azure resources and subscriptions. Advisor uses the [built-in roles](../role-based-access-control/built-in-roles.md) provided by [Azure role-based access control (Azure RBAC)](../role-based-access-control/overview.md) to manage your access to recommendations and Advisor features. 
 

articles/advisor/toc.yml

@@ -6,10 +6,16 @@
     href: advisor-overview.md
   - name: What's new?
     href: advisor-release-notes.md
-- name: Quickstarts
+- name: Get started
   items:
-  - name: Get started with Advisor
+  - name: Advisor portal basics
     href: advisor-get-started.md
+  - name: Roles and permissions
+    href: permissions.md
+  - name: Use Advisor score 
+    href: azure-advisor-score.md
+  - name: Configure recommendations view
+    href: view-recommendations.md
   - name: Configure alerts for new recommendations
     items:
     - name: Azure portal
@@ -20,22 +26,20 @@
     - name: ARM template
       displayName: Resource Manager
       href: advisor-alerts-arm.md
-- name: Concepts
+- name: Recommendations list
   items:
-  - name: Recommendations
-    items:
-    - name: Cost
-      href: advisor-reference-cost-recommendations.md
-    - name: Operational Excellence
-      href: advisor-reference-operational-excellence-recommendations.md
-    - name: Performance
-      href: advisor-reference-performance-recommendations.md
-    - name: Reliability
-      href: advisor-reference-reliability-recommendations.md    
-    - name: Security
-      href: ../defender-for-cloud/recommendations-reference.md
-    - name: Sovereign clouds
-      href: advisor-sovereign-clouds.md
+  - name: Cost
+    href: advisor-reference-cost-recommendations.md
+  - name: Operational Excellence
+    href: advisor-reference-operational-excellence-recommendations.md
+  - name: Performance
+    href: advisor-reference-performance-recommendations.md
+  - name: Reliability
+    href: advisor-reference-reliability-recommendations.md    
+  - name: Security
+    href: ../defender-for-cloud/recommendations-reference.md
+  - name: Sovereign clouds
+    href: advisor-sovereign-clouds.md
 - name: Samples 
   items:
   - name: Azure Resource Graph queries
@@ -60,20 +64,12 @@
     href: advisor-how-to-performance-resize-high-usage-vm-recommendations.md
   - name: Use tags to filter recommendations and score
     href: advisor-tag-filtering.md
-  - name: Configure recommendations
-    href: view-recommendations.md
-  - name: Permissions and blocked actions
-    href: permissions.md
-  - name: Configure Alerts for recommendations
-    href: advisor-alerts-portal.md
   - name: Configure recommendations summary
     href: advisor-recommendations-digest.md
   - name: Bulk remediation for recommendations
     href: advisor-quick-fix.md
   - name: Advisor data in Azure Resource Graph
     href: advisor-azure-resource-graph.md
-  - name: Consume Advisor score 
-    href: azure-advisor-score.md
   - name: Calculate total cost savings
     href: advisor-how-to-calculate-total-cost-savings.md
 - name: Reference

articles/advisor/view-recommendations.md

@@ -1,11 +1,11 @@
 ---
-title: View Azure Advisor recommendations that matter to you
+title: Configure Azure Advisor recommendations view
 description: View and filter Azure Advisor recommendations to reduce noise.
 ms.topic: article
 ms.date: 01/02/2024
 ---
 
-# View Azure Advisor recommendations that matter to you
+# Configure Azure Advisor recommendations view
 
 Azure Advisor provides recommendations to help you optimize your Azure deployments. Within Advisor, you have access to a few features that help you to narrow down your recommendations to only those that matter to you.
 

articles/ai-services/computer-vision/how-to/specify-detection-model.md

@@ -1,15 +1,15 @@
 ---
 title: How to specify a detection model - Face
 titleSuffix: Azure AI services
-description: This article will show you how to choose which face detection model to use with your Azure AI Face application.
+description: This article shows you how to choose which face detection model to use with your Azure AI Face application.
 #services: cognitive-services
 author: PatrickFarley
 manager: nitinme
 
 ms.service: azure-ai-vision
 ms.subservice: azure-ai-face
 ms.topic: how-to
-ms.date: 02/14/2024
+ms.date: 06/10/2024
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom: devx-track-csharp
@@ -19,7 +19,7 @@ ms.custom: devx-track-csharp
 
 This guide shows you how to specify a face detection model for the Azure AI Face service.
 
-The Face service uses machine learning models to perform operations on human faces in images. We continue to improve the accuracy of our models based on customer feedback and advances in research, and we deliver these improvements as model updates. Developers have the option to specify which version of the face detection model they'd like to use; they can choose the model that best fits their use case.
+The Face service uses machine learning models to perform operations on human faces in images. We continue to improve the accuracy of our models based on customer feedback and advances in research, and we deliver these improvements as model updates. Developers can specify which version of the face detection model they'd like to use; they can choose the model that best fits their use case.
 
 Read on to learn how to specify the face detection model in certain face operations. The Face service uses face detection whenever it converts an image of a face into some other form of data.
 
@@ -40,8 +40,8 @@ The different face detection models are optimized for different tasks. See the f
 
 | Model | Description | Performance notes   | Attributes  | Landmarks |
 |---------|------------|-------------------|-------------|--|
-|**detection_01** | Default choice for all face detection operations. | Not optimized for small, side-view, or blurry faces.                                                     | Returns main face attributes (head pose, age, emotion, and so on) if they're specified in the detect call. | Returns face landmarks if they're specified in the detect call. |
-|**detection_02** | Released in May 2019 and available optionally in all face detection operations.   | Improved accuracy on small, side-view, and blurry faces.  | Does not return face attributes. | Does not return face landmarks.     |
+|**detection_01** | Default choice for all face detection operations. | Not optimized for small, side-view, or blurry faces.                                                     | Returns main face attributes (head pose, glasses, and so on) if they're specified in the detect call. | Returns face landmarks if they're specified in the detect call. |
+|**detection_02** | Released in May 2019 and available optionally in all face detection operations.   | Improved accuracy on small, side-view, and blurry faces.  | Doesn't return face attributes. | Doesn't return face landmarks.     |
 |**detection_03** | Released in February 2021 and available optionally in all face detection operations.                   | Further improved accuracy, including on smaller faces (64x64 pixels) and rotated face orientations.       | Returns mask, blur, and head pose attributes if they're specified in the detect call. | Returns face landmarks if they're specified in the detect call. |
 
 
@@ -57,11 +57,11 @@ When you use the [Detect] API, you can assign the model version with the `detect
 * `detection_02`
 * `detection_03`
 
-A request URL for the [Detect] REST API will look like this:
+A request URL for the [Detect] REST API looks like this:
 
 `https://westus.api.cognitive.microsoft.com/face/v1.0/detect[?returnFaceId][&returnFaceLandmarks][&returnFaceAttributes][&recognitionModel][&returnRecognitionModel][&detectionModel]&subscription-key=<Subscription key>`
 
-If you are using the client library, you can assign the value for `detectionModel` by passing in an appropriate string. If you leave it unassigned, the API will use the default model version (`detection_01`). See the following code example for the .NET client library.
+If you are using the client library, you can assign the value for `detectionModel` by passing in an appropriate string. If you leave it unassigned, the API uses the default model version (`detection_01`). See the following code example for the .NET client library.
 
 ```csharp
 string imageUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-sample-data-files/master/Face/images/detection1.jpg";
@@ -85,7 +85,7 @@ string imageUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-ser
 await client.PersonGroupPerson.AddFaceFromUrlAsync(personGroupId, personId, imageUrl, detectionModel: "detection_03");
 ```
 
-This code creates a **PersonGroup** with ID `mypersongroupid` and adds a **Person** to it. Then it adds a Face to this **Person** using the `detection_03` model. If you don't specify the *detectionModel* parameter, the API will use the default model, `detection_01`.
+This code creates a **PersonGroup** with ID `mypersongroupid` and adds a **Person** to it. Then it adds a Face to this **Person** using the `detection_03` model. If you don't specify the *detectionModel* parameter, the API uses the default model, `detection_01`.
 
 > [!NOTE]
 > You don't need to use the same detection model for all faces in a **Person** object, and you don't need to use the same detection model when detecting new faces to compare with a **Person** object (in the [Identify From Person Group] API, for example).
@@ -101,7 +101,7 @@ string imageUrl = "https://raw.githubusercontent.com/Azure-Samples/cognitive-ser
 await client.FaceList.AddFaceFromUrlAsync(faceListId, imageUrl, detectionModel: "detection_03");
 ```
 
-This code creates a **FaceList** called `My face collection` and adds a Face to it with the `detection_03` model. If you don't specify the *detectionModel* parameter, the API will use the default model, `detection_01`.
+This code creates a **FaceList** called `My face collection` and adds a Face to it with the `detection_03` model. If you don't specify the *detectionModel* parameter, the API uses the default model, `detection_01`.
 
 > [!NOTE]
 > You don't need to use the same detection model for all faces in a **FaceList** object, and you don't need to use the same detection model when detecting new faces to compare with a **FaceList** object.

articles/ai-services/computer-vision/includes/image-analysis-curl-quickstart-40.md

@@ -40,7 +40,7 @@ To analyze an image for various visual features, do the following steps:
 
 1. Make the following changes in the command where needed:
     1. Replace the value of `<subscriptionKey>` with your Vision resource key.
-    1. Replace the value of `<endpoint>` with your Vision resource endpoint. For example: `https://YourResourceName.cognitiveservices.azure.com`.
+    1. Replace the value of `<endpoint>` with your Vision resource endpoint URL. For example: `https://YourResourceName.cognitiveservices.azure.com`.
     1. Optionally, change the image URL in the request body (`https://learn.microsoft.com/azure/ai-services/computer-vision/media/quickstarts/presentation.png`) to the URL of a different image to be analyzed.
 1. Open a command prompt window.
 1. Paste your edited `curl` command from the text editor into the command prompt window, and then run the command.

articles/ai-services/content-safety/concepts/groundedness.md

@@ -51,7 +51,7 @@ Currently, the Groundedness detection API supports English language content. Whi
 
 ### Text length limitations
 
-The maximum character limit for the grounding sources is 55,000 characters per API call, and for the text and query, it's 7,500 characters per API call. If your input (either text or grounding sources) exceeds these character limitations, you'll encounter an error.
+See [Input requirements](../overview.md#input-requirements) for maximum text length limitations.
 
 ### Regions
 

articles/ai-services/content-safety/concepts/jailbreak-detection.md

@@ -71,7 +71,7 @@ Currently, the Prompt Shields API supports the English language. While our API d
 
 ### Text length limitations
 
-The maximum character limit for Prompt Shields allows for a user prompt of up to 10,000 characters, while the document array is restricted to a maximum of 5 documents with a combined total not exceeding 10,000 characters.
+See [Input requirements](/azure/ai-services/content-safety/overview#input-requirements) for maximum text length limitations.
 
 ### Regions
 

articles/ai-services/content-safety/includes/quickstarts/csharp-quickstart-text.md

@@ -123,7 +123,7 @@ Replace `"Your input text"` with the text content you'd like to use.
 > [!TIP]
 > Text size and granularity
 >
-> The default maximum length for text submissions is **10K** characters.
+> See [Input requirements](../../overview.md#input-requirements) for maximum text length limitations.
 
 #### [Visual Studio IDE](#tab/visual-studio)