Use related link

Author: Shawn Lin

articles/ai-services/computer-vision/Tutorials/liveness.md

@@ -294,4 +294,4 @@ See the Azure AI Vision SDK reference to learn about other options in the livene
 
 See the Session REST API reference to learn more about the features available to orchestrate the liveness solution.
 
-- [Liveness Session Operations](https://learn.microsoft.com/rest/api/face/liveness-session-operations)
+- [Liveness Session Operations](/rest/api/face/liveness-session-operations)

articles/ai-services/computer-vision/concept-face-detection.md

@@ -102,4 +102,4 @@ Now that you're familiar with face detection concepts, learn how to write a scri
 
 * [Call the detect API](./how-to/identity-detect-faces.md)
 
-[Detect]: https://learn.microsoft.com/rest/api/face/face-detection-operations/detect
+[Detect]: /rest/api/face/face-detection-operations/detect

articles/ai-services/computer-vision/concept-face-recognition.md

@@ -30,17 +30,17 @@ You can try out the capabilities of face recognition quickly and easily using Vi
 
 ### PersonGroup creation and training
 
-You need to create a [PersonGroup](https://learn.microsoft.com/rest/api/face/person-group-operations/create-person-group) or [LargePersonGroup](https://learn.microsoft.com/rest/api/face/person-group-operations/create-large-person-group) to store the set of people to match against. PersonGroups hold [Person](https://learn.microsoft.com/rest/api/face/person-group-operations/create-person-group-person) objects, which each represent an individual person and hold a set of face data belonging to that person.
+You need to create a [PersonGroup](/rest/api/face/person-group-operations/create-person-group) or [LargePersonGroup](/rest/api/face/person-group-operations/create-large-person-group) to store the set of people to match against. PersonGroups hold [Person](/rest/api/face/person-group-operations/create-person-group-person) objects, which each represent an individual person and hold a set of face data belonging to that person.
 
-The [Train](https://learn.microsoft.com/rest/api/face/person-group-operations/train-person-group) operation prepares the data set to be used in face data comparisons.
+The [Train](/rest/api/face/person-group-operations/train-person-group) operation prepares the data set to be used in face data comparisons.
 
 ### Identification
 
-The [Identify](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-large-person-group) operation takes one or several source face IDs (from a DetectedFace or PersistedFace object) and a PersonGroup or LargePersonGroup. It returns a list of the Person objects that each source face might belong to. Returned Person objects are wrapped as Candidate objects, which have a prediction confidence value.
+The [Identify](/rest/api/face/face-recognition-operations/identify-from-large-person-group) operation takes one or several source face IDs (from a DetectedFace or PersistedFace object) and a PersonGroup or LargePersonGroup. It returns a list of the Person objects that each source face might belong to. Returned Person objects are wrapped as Candidate objects, which have a prediction confidence value.
 
 ### Verification
 
-The [Verify](https://learn.microsoft.com/rest/api/face/face-recognition-operations/verify-face-to-face) operation takes a single face ID (from a DetectedFace or PersistedFace object) and a Person object. It determines whether the face belongs to that same person. Verification is one-to-one matching and can be used as a final check on the results from the Identify API call. However, you can optionally pass in the PersonGroup to which the candidate Person belongs to improve the API performance.
+The [Verify](/rest/api/face/face-recognition-operations/verify-face-to-face) operation takes a single face ID (from a DetectedFace or PersistedFace object) and a Person object. It determines whether the face belongs to that same person. Verification is one-to-one matching and can be used as a final check on the results from the Identify API call. However, you can optionally pass in the PersonGroup to which the candidate Person belongs to improve the API performance.
 
 ## Related data structures
 

articles/ai-services/computer-vision/how-to/find-similar-faces.md

@@ -17,7 +17,7 @@ ms.author: pafarley
 
 [!INCLUDE [Gate notice](../includes/identity-gate-notice.md)]
 
-The [Find Similar](https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-large-face-list) operation does face matching between a target face and a set of candidate faces, finding a smaller set of faces that look similar to the target face. This is useful for doing a face search by image.
+The [Find Similar](/rest/api/face/face-recognition-operations/find-similar-from-large-face-list) operation does face matching between a target face and a set of candidate faces, finding a smaller set of faces that look similar to the target face. This is useful for doing a face search by image.
 
 This guide demonstrates how to use the Find Similar feature in the different language SDKs. The following sample code assumes you have already authenticated a Face client object. For details on how to do this, follow a [quickstart](../quickstarts-sdk/identity-client-library.md).
 

articles/ai-services/computer-vision/how-to/identity-detect-faces.md

@@ -23,7 +23,7 @@ ms.custom: devx-track-csharp
 
 This guide demonstrates how to use the face detection API to extract attributes from a given image. You'll learn the different ways to configure the behavior of this API to meet your needs.
 
-The code snippets in this guide are written in C# by using the Azure AI Face client library. The same functionality is available through the [REST API](https://learn.microsoft.com/rest/api/face/face-detection-operations/detect).
+The code snippets in this guide are written in C# by using the Azure AI Face client library. The same functionality is available through the [REST API](/rest/api/face/face-detection-operations/detect).
 
 
 ## Setup
@@ -98,5 +98,5 @@ In this guide, you learned how to use the various functionalities of face detect
 
 ## Related articles
 
-- [Reference documentation (REST)](https://learn.microsoft.com/rest/api/face/operation-groups)
+- [Reference documentation (REST)](/rest/api/face/operation-groups)
 - [Reference documentation (.NET SDK)](/dotnet/api/overview/azure/cognitiveservices/face-readme)

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

@@ -114,6 +114,6 @@ In this article, you learned how to specify the detection model to use with diff
 * [Face .NET SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-csharp%253fpivots%253dprogramming-language-csharp)
 * [Face Python SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-python%253fpivots%253dprogramming-language-python)
 
-[Detect]: https://learn.microsoft.com/rest/api/face/face-detection-operations/detect
-[Identify From Person Group]: https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-person-group
-[Add Person Group Person Face]: https://learn.microsoft.com/rest/api/face/person-group-operations/add-person-group-person-face
+[Detect]: /rest/api/face/face-detection-operations/detect
+[Identify From Person Group]: /rest/api/face/face-recognition-operations/identify-from-person-group
+[Add Person Group Person Face]: /rest/api/face/person-group-operations/add-person-group-person-face

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

@@ -124,15 +124,15 @@ In this article, you learned how to specify the recognition model to use with di
 * [Face .NET SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-csharp%253fpivots%253dprogramming-language-csharp)
 * [Face Python SDK](../quickstarts-sdk/identity-client-library.md?pivots=programming-language-python%253fpivots%253dprogramming-language-python)
 
-[Detect]: https://learn.microsoft.com/rest/api/face/face-detection-operations/detect
-[Verify Face To Face]: https://learn.microsoft.com/rest/api/face/face-recognition-operations/verify-face-to-face
-[Identify From Person Group]: https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-person-group
-[Find Similar]: https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-large-face-list
-[Create Person Group]: https://learn.microsoft.com/rest/api/face/person-group-operations/create-person-group
-[Get Person Group]: https://learn.microsoft.com/rest/api/face/person-group-operations/get-person-group
-[Train Person Group]: https://learn.microsoft.com/rest/api/face/person-group-operations/train-person-group
-[Add Person Group Person Face]: https://learn.microsoft.com/rest/api/face/person-group-operations/add-person-group-person-face
-[Create Large Person Group]: https://learn.microsoft.com/rest/api/face/person-group-operations/create-large-person-group
-[Create Face List]: https://learn.microsoft.com/rest/api/face/face-list-operations/create-face-list
-[Get Face List]: https://learn.microsoft.com/rest/api/face/face-list-operations/get-face-list
-[Create Large Face List]: https://learn.microsoft.com/rest/api/face/face-list-operations/create-large-face-list
+[Detect]: /rest/api/face/face-detection-operations/detect
+[Verify Face To Face]: /rest/api/face/face-recognition-operations/verify-face-to-face
+[Identify From Person Group]: /rest/api/face/face-recognition-operations/identify-from-person-group
+[Find Similar]: /rest/api/face/face-recognition-operations/find-similar-from-large-face-list
+[Create Person Group]: /rest/api/face/person-group-operations/create-person-group
+[Get Person Group]: /rest/api/face/person-group-operations/get-person-group
+[Train Person Group]: /rest/api/face/person-group-operations/train-person-group
+[Add Person Group Person Face]: /rest/api/face/person-group-operations/add-person-group-person-face
+[Create Large Person Group]: /rest/api/face/person-group-operations/create-large-person-group
+[Create Face List]: /rest/api/face/face-list-operations/create-face-list
+[Get Face List]: /rest/api/face/face-list-operations/get-face-list
+[Create Large Face List]: /rest/api/face/face-list-operations/create-large-face-list

articles/ai-services/computer-vision/how-to/use-large-scale.md

@@ -65,8 +65,8 @@ Add all of the faces and persons from the **PersonGroup** to the new **LargePers
 | - | Train |
 | - | Get Training Status |
 
-The preceding table is a comparison of list-level operations between **FaceList** and **LargeFaceList**. As is shown, **LargeFaceList** comes with new operations, [Train](https://learn.microsoft.com/rest/api/face/face-list-operations/train-large-face-list) and [Get Training Status](https://learn.microsoft.com/rest/api/face/face-list-operations/get-large-face-list-training-status), when compared with **FaceList**. Training the **LargeFaceList** is a precondition of the 
-[FindSimilar](https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-large-face-list) operation. Training isn't required for **FaceList**. The following snippet is a helper function to wait for the training of a **LargeFaceList**:
+The preceding table is a comparison of list-level operations between **FaceList** and **LargeFaceList**. As is shown, **LargeFaceList** comes with new operations, [Train](/rest/api/face/face-list-operations/train-large-face-list) and [Get Training Status](/rest/api/face/face-list-operations/get-large-face-list-training-status), when compared with **FaceList**. Training the **LargeFaceList** is a precondition of the 
+[FindSimilar](/rest/api/face/face-recognition-operations/find-similar-from-large-face-list) operation. Training isn't required for **FaceList**. The following snippet is a helper function to wait for the training of a **LargeFaceList**:
 
 ```csharp
 /// <summary>
@@ -190,8 +190,8 @@ As previously shown, the data management and the **FindSimilar** part are almost
 
 ## Step 3: Train suggestions
 
-Although the **Train** operation speeds up [FindSimilar](https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-large-face-list)
-and [Identification](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-large-person-group), the training time suffers, especially when coming to large scale. The estimated training time in different scales is listed in the following table.
+Although the **Train** operation speeds up [FindSimilar](/rest/api/face/face-recognition-operations/find-similar-from-large-face-list)
+and [Identification](/rest/api/face/face-recognition-operations/identify-from-large-person-group), the training time suffers, especially when coming to large scale. The estimated training time in different scales is listed in the following table.
 
 | Scale for faces or persons | Estimated training time |
 |:---:|:---:|

articles/ai-services/computer-vision/identity-api-reference.md

@@ -17,10 +17,10 @@ ms.author: nitinme
 
 Azure AI Face is a cloud-based service that provides algorithms for face detection and recognition. The Face APIs comprise the following categories:
 
-- Face Algorithm APIs: Cover core functions such as [Detection](https://learn.microsoft.com/rest/api/face/face-detection-operations/detect), [Find Similar](https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-large-face-list), [Verification](https://learn.microsoft.com/rest/api/face/face-recognition-operations/verify-face-to-face), [Identification](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-large-person-group), and [Group](https://learn.microsoft.com/rest/api/face/face-recognition-operations/group).
-- [DetectLiveness session APIs](https://learn.microsoft.com/rest/api/face/liveness-session-operations): Used to create and manage a Liveness Detection session. See the [Liveness Detection](/azure/ai-services/computer-vision/tutorials/liveness) tutorial.
-- [FaceList APIs](https://learn.microsoft.com/rest/api/face/face-list-operations): Used to manage a FaceList for [Find Similar From Face List](https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-face-list).
-- [LargeFaceList APIs](https://learn.microsoft.com/rest/api/face/face-list-operations): Used to manage a LargeFaceList for [Find Similar From Large Face List](https://learn.microsoft.com/rest/api/face/face-recognition-operations/find-similar-from-large-face-list).
-- [PersonGroup APIs](https://learn.microsoft.com/rest/api/face/person-group-operations): Used to manage a PersonGroup dataset for [Identification From Person Group](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-person-group).
-- [LargePersonGroup APIs](https://learn.microsoft.com/rest/api/face/person-group-operations): Used to manage a LargePersonGroup dataset for [Identification From Large Person Group](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-large-person-group).
-- [PersonDirectory APIs](https://learn.microsoft.com/rest/api/face/person-directory-operations): Used to manage a PersonDirectory dataset for [Identification From Person Directory](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-person-directory) or [Identification From Dynamic Person Group](https://learn.microsoft.com/rest/api/face/face-recognition-operations/identify-from-dynamic-person-group).
+- Face Algorithm APIs: Cover core functions such as [Detection](/rest/api/face/face-detection-operations/detect), [Find Similar](/rest/api/face/face-recognition-operations/find-similar-from-large-face-list), [Verification](/rest/api/face/face-recognition-operations/verify-face-to-face), [Identification](/rest/api/face/face-recognition-operations/identify-from-large-person-group), and [Group](/rest/api/face/face-recognition-operations/group).
+- [DetectLiveness session APIs](/rest/api/face/liveness-session-operations): Used to create and manage a Liveness Detection session. See the [Liveness Detection](/azure/ai-services/computer-vision/tutorials/liveness) tutorial.
+- [FaceList APIs](/rest/api/face/face-list-operations): Used to manage a FaceList for [Find Similar From Face List](/rest/api/face/face-recognition-operations/find-similar-from-face-list).
+- [LargeFaceList APIs](/rest/api/face/face-list-operations): Used to manage a LargeFaceList for [Find Similar From Large Face List](/rest/api/face/face-recognition-operations/find-similar-from-large-face-list).
+- [PersonGroup APIs](/rest/api/face/person-group-operations): Used to manage a PersonGroup dataset for [Identification From Person Group](/rest/api/face/face-recognition-operations/identify-from-person-group).
+- [LargePersonGroup APIs](/rest/api/face/person-group-operations): Used to manage a LargePersonGroup dataset for [Identification From Large Person Group](/rest/api/face/face-recognition-operations/identify-from-large-person-group).
+- [PersonDirectory APIs](/rest/api/face/person-directory-operations): Used to manage a PersonDirectory dataset for [Identification From Person Directory](/rest/api/face/face-recognition-operations/identify-from-person-directory) or [Identification From Dynamic Person Group](/rest/api/face/face-recognition-operations/identify-from-dynamic-person-group).