Update Face description for links (Azure#30263)

* Update detection description
* Update add Face description

specification/ai/Face/models.common.tsp

@@ -282,15 +282,12 @@ model GroupingResult {
 }
 
 alias AddFaceDescriptionInList = """
-  >
-  *
     * Higher face image quality means better recognition precision. Please consider high-quality faces: frontal, clear, and face size is 200x200 pixels (100 pixels between eyes) or bigger.
-    * Each person entry can hold up to 248 faces.
     * JPEG, PNG, GIF (the first frame), and BMP format are supported. The allowed image file size is from 1KB to 6MB.
     * "targetFace" rectangle should contain one face. Zero or multiple faces will be regarded as an error. If the provided "targetFace" rectangle is not returned from \"Detect\", there's no guarantee to detect and add the face successfully.
     * Out of detectable face size (36x36 - 4096x4096 pixels), large head-pose, or large occlusions will cause failures.
     * The minimum detectable face size is 36x36 pixels in an image no larger than 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will need a proportionally larger minimum face size.
-    * Different 'detectionModel' values can be provided. To use and compare different detection models, please refer to https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
+    * Different 'detectionModel' values can be provided. To use and compare different detection models, please refer to [here](https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model).
   """;
 
 alias ListRequestOptionsDescriptionInList = """

specification/ai/Face/routes.detection.tsp

@@ -17,7 +17,7 @@ namespace Face;
 @summary("Detect human faces in an image, return face rectangles, and optionally with faceIds, landmarks, and attributes.")
 @doc("""
   > [!IMPORTANT]
-  > Microsoft has retired or limited facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. The retired capabilities are emotion and gender. The limited capabilities are age, smile, facial hair, hair and makeup. Email Azure Face API <azureface@microsoft.com> if you have a responsible use case that would benefit from the use of any of the limited capabilities. Read more about this decision https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.
+  > Microsoft has retired or limited facial recognition capabilities that can be used to try to infer emotional states and identity attributes which, if misused, can subject people to stereotyping, discrimination or unfair denial of services. The retired capabilities are emotion and gender. The limited capabilities are age, smile, facial hair, hair and makeup. Email [Azure Face API](mailto:azureface@microsoft.com) if you have a responsible use case that would benefit from the use of any of the limited capabilities. Read more about this decision [here](https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/).
 
   *
     * No image will be stored. Only the extracted face feature(s) will be stored on server. The faceId is an identifier of the face feature and will be used in \"Identify\", \"Verify\", and \"Find Similar\". The stored face features will expire and be deleted at the time specified by faceIdTimeToLive after the original detection call.
@@ -26,10 +26,8 @@ namespace Face;
     * The minimum detectable face size is 36x36 pixels in an image no larger than 1920x1080 pixels. Images with dimensions higher than 1920x1080 pixels will need a proportionally larger minimum face size.
     * Up to 100 faces can be returned for an image. Faces are ranked by face rectangle size from large to small.
     * For optimal results when querying \"Identify\", \"Verify\", and \"Find Similar\" ('returnFaceId' is true), please use faces that are: frontal, clear, and with a minimum size of 200x200 pixels (100 pixels between eyes).
-    * Different 'detectionModel' values can be provided. To use and compare different detection models, please refer to https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
-      * 'detection_02': Face attributes and landmarks are disabled if you choose this detection model.
-      * 'detection_03': Face attributes (mask, blur, and headPose) and landmarks are supported if you choose this detection model.
-    * Different 'recognitionModel' values are provided. If follow-up operations like \"Verify\", \"Identify\", \"Find Similar\" are needed, please specify the recognition model with 'recognitionModel' parameter. The default value for 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in this parameter. Once specified, the detected faceIds will be associated with the specified recognition model. More details, please refer to https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.
+    * Different 'detectionModel' values can be provided. The availability of landmarks and supported attributes depends on the detection model specified. To use and compare different detection models, please refer to [here](https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model).
+    * Different 'recognitionModel' values are provided. If follow-up operations like \"Verify\", \"Identify\", \"Find Similar\" are needed, please specify the recognition model with 'recognitionModel' parameter. The default value for 'recognitionModel' is 'recognition_01', if latest model needed, please explicitly specify the model you need in this parameter. Once specified, the detected faceIds will be associated with the specified recognition model. More details, please refer to [here](https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model).
   """)
 @returnsDoc("A successful call returns an array of face entries ranked by face rectangle size in descending order. An empty response indicates no faces detected.")
 @post

specification/ai/Face/routes.facelist.tsp

@@ -16,13 +16,19 @@ alias AddFaceListFaceDescription = """
   To deal with an image containing multiple faces, input face can be specified as an image with a targetFace rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature(s) will be stored on server until \"Delete Face List Face\" or \"Delete Face List\" is called.
 
   Note that persistedFaceId is different from faceId generated by \"Detect\".
+
+  >
+  *
   ${AddFaceDescriptionInList}
   """;
 alias AddLargeFaceListFaceSummary = "Add a face to a specified Large Face List, up to 1,000,000 faces.";
 alias AddLargeFaceListFaceDescription = """
   To deal with an image containing multiple faces, input face can be specified as an image with a targetFace rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature(s) will be stored on server until \"Delete Large Face List Face\" or \"Delete Large Face List\" is called.
 
   Note that persistedFaceId is different from faceId generated by \"Detect\".
+
+  >
+  *
   ${AddFaceDescriptionInList}
 
   > [!NOTE]

specification/ai/Face/routes.persondirectory.tsp

@@ -18,8 +18,11 @@ namespace Face;
   To deal with an image containing multiple faces, input face can be specified as an image with a targetFace rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature(s) will be stored on server until Person Directory \"Delete Person Face\" or \"Delete Person\" is called.
 
   Note that persistedFaceId is different from faceId generated by \"Detect\".
-  ${AddFaceDescriptionInList}
+
+  >
   *
+    * Each person entry can hold up to 248 faces.
+  ${AddFaceDescriptionInList}
     * Adding/deleting faces to/from a same person will be processed sequentially. Adding/deleting faces to/from different persons are processed in parallel.
     * This is a long running operation. Use Response Header "Operation-Location" to determine when the AddFace operation has successfully propagated for future requests to \"Identify\". For further information about Operation-Locations see \"Get Face Operation Status\".
   """)

specification/ai/Face/routes.persongroup.tsp

@@ -16,13 +16,21 @@ alias AddPersonGroupPersonFaceDescription = """
   To deal with an image containing multiple faces, input face can be specified as an image with a targetFace rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature(s) will be stored on server until \"Delete Person Group Person Face\", \"Delete Person Group Person\" or \"Delete Person Group\" is called.
 
   Note that persistedFaceId is different from faceId generated by \"Detect\".
+
+  >
+  * 
+    * Each person entry can hold up to 248 faces.
   ${AddFaceDescriptionInList}
   """;
 alias AddLargePersonGroupPersonFaceSummary = "Add a face to a person into a Large Person Group for face identification or verification.";
 alias AddLargePersonGroupPersonFaceDescription = """
   To deal with an image containing multiple faces, input face can be specified as an image with a targetFace rectangle. It returns a persistedFaceId representing the added face. No image will be stored. Only the extracted face feature(s) will be stored on server until \"Delete Large Person Group Person Face\", \"Delete Large Person Group Person\" or \"Delete Large Person Group\" is called.
 
   Note that persistedFaceId is different from faceId generated by \"Detect\".
+
+  >
+  *
+    * Each person entry can hold up to 248 faces.
   ${AddFaceDescriptionInList}
   """;
 alias CreatePersonSuccess = "A successful call returns a new personId created.";