Merge pull request #202715 from PatrickFarley/comvis-updates

[cog svcs] add preview callout to article

Author: v-dirichards

articles/cognitive-services/Computer-vision/concept-face-recognition.md

@@ -34,7 +34,7 @@ The recognition operations use mainly the following data structures. These objec
 |[FaceList](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039524b) or [LargeFaceList](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/5a157b68d2de3616c086f2cc)| This data structure is an assorted list of PersistedFace objects. A FaceList has a unique ID, a name string, and optionally a user data string.|
 |[Person](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523c)| This data structure is a list of PersistedFace objects that belong to the same person. It has a unique ID, a name string, and optionally a user data string.|
 |[PersonGroup](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244) or [LargePersonGroup](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/599acdee6ac60f11b48b5a9d)| This data structure is an assorted list of Person objects. It has a unique ID, a name string, and optionally a user data string. A PersonGroup must be [trained](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395249) before it can be used in recognition operations.|
-|PersonDirectory | This data structure is like **LargePersonGroup** but offers additional storage capacity and other added features. For more information, see [Use the PersonDirectory structure](./how-to/use-persondirectory.md).
+|PersonDirectory | This data structure is like **LargePersonGroup** but offers additional storage capacity and other added features. For more information, see [Use the PersonDirectory structure (preview)](./how-to/use-persondirectory.md).
 
 ## Recognition operations
 

articles/cognitive-services/Computer-vision/how-to/add-faces.md

@@ -139,4 +139,4 @@ The following features were explained and demonstrated:
 
 In this guide, you learned how to add face data to a **PersonGroup**. Next, learn how to use the enhanced data structure **PersonDirectory** to do more with your face data.
 
-- [Use the PersonDirectory structure](use-persondirectory.md)
+- [Use the PersonDirectory structure (preview)](use-persondirectory.md)

articles/cognitive-services/Computer-vision/how-to/use-persondirectory.md

@@ -15,11 +15,11 @@ ms.devlang: csharp
 ms.custom: [devx-track-csharp, cogserv-non-critical-vision]
 ---
 
-# Use the PersonDirectory structure
+# Use the PersonDirectory structure (preview)
 
 [!INCLUDE [Gate notice](../includes/identity-gate-notice.md)]
 
-To perform face recognition operations such as Identify and Find Similar, Face API customers need to create an assorted list of **Person** objects. The new **PersonDirectory** is a data structure that contains unique IDs, optional name strings, and optional user metadata strings for each **Person** identity added to the directory.
+To perform face recognition operations such as Identify and Find Similar, Face API customers need to create an assorted list of **Person** objects. The new **PersonDirectory** is a data structure in Public Preview that contains unique IDs, optional name strings, and optional user metadata strings for each **Person** identity added to the directory.
 
 Currently, the Face API offers the **LargePersonGroup** structure, which has similar functionality but is limited to 1 million identities. The **PersonDirectory** structure can scale up to 75 million identities.
 

articles/cognitive-services/Computer-vision/index-identity.yml

@@ -47,8 +47,6 @@ landingContent:
             url: how-to/add-faces.md
           - text: Use the large-scale feature
             url: how-to/use-large-scale.md
-          - text: Use the PersonDirectory structure
-            url: how-to/use-persondirectory.md
           - text: Specify a face recognition model version
             url: how-to/specify-recognition-model.md
 

articles/cognitive-services/Computer-vision/toc.yml

@@ -194,7 +194,7 @@ items:
       href: how-to/add-faces.md
     - name: Use the large-scale feature
       href: how-to/use-large-scale.md
-    - name: Use the PersonDirectory structure
+    - name: Use the PersonDirectory structure (preview)
       href: how-to/use-persondirectory.md
     - name: Use the HeadPose attribute
       href: how-to/use-headpose.md

articles/cognitive-services/Computer-vision/whats-new.md

@@ -133,7 +133,7 @@ The Computer Vision API v3.2 is now generally available with the following updat
 > [!div class="nextstepaction"]
 > [See Computer Vision v3.2 GA](https://westus.dev.cognitive.microsoft.com/docs/services/computer-vision-v3-2/operations/5d986960601faab4bf452005)
 
-### PersonDirectory data structure
+### PersonDirectory data structure (preview)
 
 * In order to perform face recognition operations such as Identify and Find Similar, Face API customers need to create an assorted list of **Person** objects. The new **PersonDirectory** is a data structure that contains unique IDs, optional name strings, and optional user metadata strings for each **Person** identity added to the directory. Currently, the Face API offers the **LargePersonGroup** structure which has similar functionality but is limited to 1 million identities. The **PersonDirectory** structure can scale up to 75 million identities.
 * Another major difference between **PersonDirectory** and previous data structures is that you'll no longer need to make any Train calls after adding faces to a **Person** object—the update process happens automatically. For more details see [Use the PersonDirectory structure](how-to/use-persondirectory.md).